매뉴얼 페이지에서 정보 찾기

man 명령을 사용하여 매뉴얼 페이지에서 Oracle Solaris 명령에 대한 정보를 검색할 수 있습니다. 새 -K(대문자) keywords 옵션을 사용하면 모든 매뉴얼 페이지의 모든 섹션에서 지정된 키워드를 검색할 수 있습니다. -k 옵션(소문자)은 모든 매뉴얼 페이지 섹션의 NAME 하위 섹션만 검색하도록 제한됩니다.

매뉴얼 페이지에서 특정 키워드를 검색할 수 있도록 색인 파일 만들기

키워드를 지정하여 매뉴얼 페이지에서 정보를 검색하려면 먼저 man 명령이 질의할 수 있는 색인 파일을 만듭니다. catman 유틸리티를 사용하여 규격화된 서식의 온라인 참조 매뉴얼을 만들 수 있습니다. 옵션 없이 사용할 경우 catman 유틸리티는 /usr/share/man 및 usr/gnu/share/man 디렉토리에 있는 매뉴얼 페이지의 색인 파일을 생성합니다. catman 유틸리티를 사용하려면 root 사용자여야 합니다.

또한 catman 유틸리티에는 -w 옵션이 포함되어 있습니다. 이 옵션을 사용하면 MANPATH 변수나 -M 옵션에 지정된 디렉토리에 있는 매뉴얼 페이지의 색인 파일을 만들 수 있습니다. catman 유틸리티의 -M 옵션을 사용하면 타사 매뉴얼 페이지의 색인 파일을 만들기 위한 대체 디렉토리를 지정할 수 있습니다. 기본적으로 옵션 없이 사용할 경우 catman 유틸리티는 /usr/share/man 및 /usr/gnu/share/man 디렉토리에 있는 매뉴얼 페이지의 색인 파일을 만듭니다.

대체 디렉토리를 지정하려면 다음 명령을 입력합니다.

# catman -M directory -w

예를 들어, /usr/local/share/man 디렉토리에 있는 매뉴얼 페이지에 대한 색인 파일을 만들려면 다음 명령을 입력합니다.

# catman -M /usr/local/share/man -w

-M directory

지정된 디렉토리(기본적으로 /usr/share/man)에 있는 매뉴얼 페이지를 업데이트합니다. -M 옵션이 지정된 경우 디렉토리 인수에 쉼표(,)를 포함하지 않아야 합니다. 이는 쉼표가 매뉴얼 페이지에서 섹션 번호를 지정하는 데 사용되기 때문입니다.

-w

MANPATH 변수나 -M 옵션을 사용하여 지정된 디렉토리에 색인 파일을 만듭니다. MANPATH 변수 또는 -M 옵션이 지정되지 않은 경우 /usr/share/man/ 및 /usr/gnu/share/man 디렉토리 둘 다에 대한 색인 파일이 만들어집니다.

지정할 수 있는 모든 명령줄 옵션을 비롯하여 catman 유틸리티에 대한 자세한 내용은 catman(1M) 매뉴얼 페이지를 참조하십시오.

키워드를 지정하여 매뉴얼 페이지에서 정보 검색

키워드를 지정하여 매뉴얼 페이지에서 정보를 검색하려면 catman 유틸리티를 사용하여 색인 파일을 만듭니다. 지침은 매뉴얼 페이지에서 특정 키워드를 검색할 수 있도록 색인 파일 만들기를 참조하십시오.

키워드를 지정하여 모든 매뉴얼 페이지 섹션에서 정보의 전체 텍스트 검색을 수행하려면 다음과 같이 새 -K keywords 옵션과 함께 man 명령을 입력합니다.

$ man -K keywords

-K

모든 매뉴얼 페이지 섹션에서 지정된 keywords의 전체 텍스트 검색을 수행합니다.

keywords

지정된 사용자 정의 문자열입니다. 단일 검색에서 여러 키워드를 지정하려면 큰따옴표를 사용합니다. 예를 들면 다음과 같습니다.

$ man -K "create zfs pool"

단지 모든 매뉴얼 페이지의 NAME 섹션에서만 정보를 검색하려면 다음과 같이 man 명령과 함께 -k keywords 옵션을 입력합니다.

$ man -k keywords

모든 매뉴얼 페이지의 특정 하위 섹션에서 정보를 검색하려면 다음과 같이 SECTNAME을 man - K keywords 명령 구문에 포함합니다.

$ man -K SECTNAME:keywords

여기서 SECTNAME은 모든 매뉴얼 페이지 섹션에 있는 다음과 같은 하위 섹션일 수 있습니다.

• ATTRIBUTES

• DESCRIPTION

• ENVIRONMENT VARIABLES

• EXAMPLES

• EXIT STATUS

• FILES

• LIST OF COMMANDS

• NAME

• NOTES

• NULL

• OPTIONS

• OPERANDS

• OUTPUT

• SECURITY

• SEE ALSO

• SYNOPSIS

• USAGE

특정 매뉴얼 페이지 섹션을 검색하려면 man 명령 및 -k 또는 -K 옵션과 함께 -s 옵션을 사용합니다.

$ man -s manpage-section -K "keywords"

예를 들어, 1M 매뉴얼 페이지 섹션에서 "cpu usage" 키워드를 검색하려면 다음 명령을 입력합니다.

$ man -s 1m -K "cpu usage"

man 명령에 대한 다음과 같은 추가 정보도 중요합니다.

• man 명령과 함께 -k 또는 -K 옵션을 사용하여 매뉴얼 페이지를 검색하는 데 사용되는 명령 구문은 대소문자를 구분하지 않습니다.

• man 명령은 검색을 수행하기 전에 키워드를 정규화합니다. 이는 지정된 키워드에 대한 질의가 해당 단어의 일부를 포함하는 모든 단어에 대해서도 결과를 생성한다는 것을 의미합니다. 예를 들어, 단어 "searching"을 질의할 경우 단어 "search", "searches" 및 "searched"도 검색 결과에 포함됩니다.

예 1-1 키워드를 지정하여 모든 매뉴얼 페이지의 NAME 하위 섹션에서 명령 검색

다음 예에서는 man -k 명령을 사용하여 모든 매뉴얼 페이지의 단지 NAME 섹션에서만 init 명령 인스턴스를 검색합니다.

$ man -k init
Searching in: /usr/man
Searching in: /usr/dt/man
Searching in: /usr/openwin/share/man
Searching in: /usr/sfw/man

1. init(1m)     "NAME"  /usr/share/man/man1m/init.1m
init, telinit - process control initialization


2. inittab(4)   "NAME"  /usr/share/man/man4/inittab.4
inittab - script for init


3. init.d(4)    "NAME"  /usr/share/man/man4/init.d.4
init.d - initialization and termination scripts for changing init states

이 예에서 man -k 명령 출력에는 모든 매뉴얼 페이지 섹션의 NAME 하위 섹션에만 있는 init 명령에 대한 검색 결과가 표시됩니다. 이름에 init가 포함된 모든 매뉴얼 페이지도 검색 결과에 포함됩니다.

예 1-2 키워드를 지정하여 모든 매뉴얼 페이지 섹션에서 명령 검색

다음 예에서는 man -K keywords 명령을 사용하여 매뉴얼 페이지의 모든 섹션에서 dumpadm 명령 인스턴스를 검색합니다.

$ man -K dumpadm
Searching in: /usr/man
Searching in: /usr/dt/man
Searching in: /usr/openwin/share/man
Searching in: /usr/sfw/man

1. dumpadm(1m)  NAME    /usr/share/man/man1m/dumpadm.1m
dumpadm - configure operating system crash dump


2. savecore(1m) DESCRIPTION     /usr/share/man/man1m/savecore.1m
The savecore utility saves a crash dump of the kernel (assuming that one
was made) and writes a reboot message in the shutdown log. It is invoked
by the dumpadm service each time the system boots.


3. svccfg(1m)   EXAMPLES        /usr/sh

이 예에서는 검색 결과 매뉴얼 페이지에 있는 세 개의 dumpadm 인스턴스가 반환됩니다.

• 첫번째 인스턴스는 dumpadm(1M) 매뉴얼 페이지의 NAME 하위 섹션에서 발견되었습니다.

• 두번째 인스턴스는 savecore(1M) 매뉴얼 페이지의 DESCRIPTION 하위 섹션에서 발견되었습니다.

• 세번째 인스턴스는 svccfg(1M) 매뉴얼 페이지의 EXAMPLES 하위 섹션에서 발견되었습니다.

이 질의의 결과에 기초하여 모든 매뉴얼 페이지에서 dumpadm 명령에 대한 추가 정보를 찾을 수 있는 위치를 알 수 있습니다.

예 1-3 키워드를 지정하여 특정 매뉴얼 페이지 하위 섹션에서 명령 검색

다음 예에서는 man -K 명령을 SECTNAME: keywords 인수와 함께 사용하여 모든 매뉴얼 페이지 섹션의 DESCRIPTION 하위 섹션에서 bootadm 명령 인스턴스를 검색합니다.

$ man -K description:bootadm
Searching in: /usr/man
Searching in: /usr/dt/man
Searching in: /usr/openwin/share/man
Searching in: /usr/sfw/man

1. bootadm(1m)  DESCRIPTION     /usr/share/man/man1m/bootadm.1m
The bootadm command manages the boot archive and, with x86 boot environments,
the GRUB (GRand Unified Bootloader) menu. The update-archive option
provides a way for user to update the boot archive as a preventative
measure or as part of a


2. boot(1m)     DESCRIPTION     /usr/share/man/man1m/boot.1m
# bootadm update-archive

이 예에서는 검색 결과 다음 매뉴얼 페이지 섹션의 DESCRIPTION 하위 섹션에 있는 두 개의 bootadm 명령 인스턴스가 반환됩니다.

• 첫번째 인스턴스는 bootadm(1M) 매뉴얼 페이지에서 발견되었습니다.

• 두번째 인스턴스는 boot(1M) 매뉴얼 페이지에서 발견되었습니다.

man 명령 사용에 대한 자세한 내용은 man(1) 매뉴얼 페이지를 참조하십시오.