리눅스 / 명령어 / man / 명령어의 설명서 출력하는 명령어
Linux에서 man 명령을 사용하면 설치된 명령어와 시스템 기능의 매뉴얼 페이지를 볼 수 있습니다. 예를 들어 man ls를 실행하면 ls의 사용법과 옵션을 읽고, 일반적으로 q를 눌러 화면을 종료할 수 있습니다.
매뉴얼 페이지 열기
man은 manual의 약자로, 시스템에 설치된 매뉴얼 페이지를 찾아 보여 줍니다. 프로그램뿐 아니라 설정 파일 형식, 시스템 호출, 라이브러리 함수에 관한 페이지도 있습니다. 예를 들어 다음 명령은 ls 매뉴얼을 엽니다.
man ls매뉴얼에는 보통 NAME에 이름과 짧은 설명, SYNOPSIS에 명령 형식, DESCRIPTION과 OPTIONS에 기능과 옵션이 나옵니다. 내용과 제목 구역은 프로그램마다 다를 수 있습니다. 매뉴얼을 읽는 동작은 설명된 명령을 실행하거나 시스템 설정을 변경하지 않습니다.
화면 이동과 검색
man은 긴 내용을 페이지 단위로 표시하기 위해 페이지 표시 프로그램을 사용합니다. 아래 조작은 일반적으로 사용되는 less 기준입니다. 다른 프로그램이 설정되어 있으면 키가 다를 수 있습니다.
- 아래·위 화살표: 한 줄씩 이동합니다.
- Space 또는 Page Down: 한 화면 아래로 이동합니다.
b또는 Page Up은 한 화면 위로 이동합니다. /다음 검색어와 Enter: 현재 위치에서 앞으로 검색합니다.n은 같은 방향의 다음 결과,N은 반대 방향의 결과로 이동합니다.g와G: 각각 문서의 처음과 끝으로 이동합니다. 대소문자를 구분합니다.h와q:h는 조작 도움말을 열고,q는 도움말 또는 매뉴얼 화면을 종료합니다.
예를 들어 man ls 화면에서 /sort를 입력하고 Enter를 누르면 뒤쪽에서 해당 표현을 찾습니다. 검색어는 셸 명령이 아니라 매뉴얼 화면 안에서 입력합니다. 자세한 키와 검색 규칙은 less 매뉴얼을 참고하세요.
같은 이름의 매뉴얼 구역 선택하기
매뉴얼은 주제에 따라 번호가 있는 구역으로 나뉩니다. 같은 이름이 여러 구역에 있으면 번호를 지정해 원하는 페이지를 열 수 있습니다. 예를 들어 passwd는 사용자 암호 관련 명령과 계정 정보 파일의 이름으로 모두 쓰입니다.
man 1 passwd
man 5 passwd첫 명령은 명령어의 매뉴얼을, 두 번째는 파일 형식의 매뉴얼을 찾습니다. 해당 페이지가 시스템에 설치되어 있어야 표시됩니다. 번호를 생략하면 설정된 검색 순서에 따라 먼저 발견한 페이지가 열립니다.
- 1: 일반 명령과 실행 프로그램
- 2: 시스템 호출
- 3: 라이브러리 함수
- 5: 파일 형식과 규칙
- 8: 시스템 관리 명령
passwd(5) 같은 표기는 이름과 구역 번호를 함께 나타냅니다. 전체 구역과 검색 방법은 man 매뉴얼에서 확인할 수 있습니다.
이름이나 주제로 페이지 찾기
정확한 명령 이름을 모르면 man -k로 매뉴얼 이름과 짧은 설명을 검색할 수 있습니다. 다음 예제는 password와 관련된 항목을 찾습니다.
man -k password결과에는 페이지 이름, 구역 번호와 짧은 설명이 표시됩니다. 검색어는 정규 표현식으로 해석될 수 있으며, 이 검색은 매뉴얼 본문 전체를 검색하는 것이 아닙니다. 찾은 항목은 이름과 구역 번호를 사용해 man 5 passwd처럼 열 수 있습니다.
이름을 이미 알고 짧은 설명만 보고 싶다면 다음과 같이 실행합니다.
man -f lsman -k와 man -f는 매뉴얼 색인을 사용하므로 설치된 문서나 색인 상태에 따라 결과가 다를 수 있습니다.
매뉴얼을 찾지 못할 때
- 페이지가 없음: 이름의 철자를 확인하고 프로그램과 해당 문서 패키지가 설치되어 있는지 살펴보세요. 최소 설치 환경에는 매뉴얼이 빠져 있을 수 있습니다.
- 내장 명령:
cd처럼 셸에 내장된 명령은 별도의 페이지가 없을 수 있습니다. Bash에서는help cd나man bash를 확인할 수 있습니다. - 검색 결과가 없음: 문서가 설치되어 있는지와 매뉴얼 색인이 준비되어 있는지 확인하세요. 색인 재생성 방법과 권한은 배포판의 문서를 따르세요.
- 언어가 다름: 설치된 번역과 로캘 설정에 따라 영어로 표시될 수 있습니다. 옵션과 예제는 설치된 소프트웨어 버전의 문서를 기준으로 확인하세요.
명령 자체가 제공하는 간단한 도움말이 필요하면 해당 프로그램의 --help 옵션을 확인할 수도 있습니다. man 자체의 사용법은 man man으로 볼 수 있습니다.
