맨 페이지

man page
man 페이지:man(1)을 참조해 주세요.이 버전은 man-db에서 가져온 것입니다.

man 페이지(수동 페이지의 줄임말)는 일반적으로 Unix 또는 Unix와 유사한 운영 체제에서 볼 수 있는 소프트웨어 문서의 한 형태입니다.여기서는 컴퓨터 프로그램(라이브러리 및 시스템 호출 포함), 정식 표준 및 규칙, 추상 개념에 대해 설명합니다.사용자는 다음 명령어를 발행하여 man 페이지를 호출할 수 있습니다.man 명령어를 입력합니다.

디폴트로는man는 일반적으로 다음과 같은 단말 호출기 프로그램을 사용합니다.more또는less출력을 표시합니다.

man page는 온라인 또는 온라인 형식의 소프트웨어 [1]문서라고 불리기도 합니다.man이 명령어는 인터넷 접속을 필요로 하지 않습니다.인쇄된 대역 외 매뉴얼이 일반적이던 시대로 거슬러 올라갑니다.

역사

수동 페이지를 표시하기 위한 초기 X11 응용 프로그램인 xman
OpenBSD 섹션 8 소개 페이지, 텍스트 콘솔에 표시

Unix의 역사가 시작된 첫 2년 동안은 [2]문서가 존재하지 않았습니다.UNIX 프로그래머 매뉴얼은 1971년 11월 3일에 처음 출판되었습니다.최초의 실제 맨 페이지는 1971년 데니스 리치와 켄 톰슨이 매니저 더그 맥일로이의 주장으로 작성했다[citation needed].man 페이지 외에도 프로그래머 매뉴얼에는 짧은 문서 세트, 일부 튜토리얼(일반 Unix 사용법, C 프로그래밍 언어, Yacc 등의 도구용) 및 기타 운영 체제 기능에 대한 자세한 설명이 정리되어 있습니다.매뉴얼 인쇄판은 처음에는 하나의 바인더에 들어가지만, PWB/UNIX와 Research Unix 제7판에서는 두 권으로 나뉘어 인쇄된 [3]man printed man page가 작성되었습니다.

그 문서의 후기 버전은 최초의 남성 페이지들의 지루함을 모방했다.리치는 제3판의 도입부에 「How to get start」섹션을 추가해, 로린다 체리는 제6판과 제7판의 [2]포켓 레퍼런스를 제공했다.소프트웨어의 버전은 매뉴얼의 개정판을 따서 명명되었습니다. 예를 들어 Unix Programmer's Manual의 제7판은 [4]Unix의 제7판 또는 Version 7과 함께 제공됩니다.

제4판의 경우 man 페이지는 troff 조판 패키지와[2] 그 세트를 사용하여 포맷되었습니다.-man매크로(매뉴얼 [3]제6판과 제7판 사이에 완전히 개정되었지만, 그 이후에는 크게 변경되지 않았습니다).당시에는 매뉴얼 페이지 시스템을 통한 온라인 문서화가 큰 발전으로 여겨졌습니다.오늘날까지 거의 모든 Unix 명령줄 어플리케이션에는 man 페이지가 포함되어 있으며, 많은 Unix 사용자들은 프로그램의 man 페이지 부족을 저품질의 신호로 인식하고 있습니다.실제로 Debian과 같은 일부 프로젝트는 man 페이지가 없는 프로그램의 man 페이지를 작성하기 위해 최선을 다하고 있습니다.4.4의 현대적 후예BSD는 또한 시스템 문서의 주요 형식 중 하나로 man page를 배포합니다(구형을 대체).-man최신 버전을 사용한 매크로-mdoc).

man 명령어 man-db 버전에는 숨겨진 이스터 에그가 있어 00:30에 실행되었을 때 명령어가 "gimme me me"를 반환하게 됩니다(ABBA의 노래인 Gime를 참조). 이리 줘! 이리 줘!그것은 2011년에[5] 도입되었지만, 처음 제한되었다가[6] 2017년에[7] 마침내 [8]발견되어 제거되었다.

포맷

FreeB의 일부SDman (1) 매뉴얼 페이지, PDF 형식으로 인쇄.

man 페이지의 기본 형식은 macro package man(외관 지향) 또는 mdoc(의미 지향) 중 하나입니다.이를 통해 man 페이지를 PostScript, PDF 및 기타 다양한 형식으로 타이핑하여 보거나 인쇄할 수 있습니다.

일부 Unix 시스템에는 man2html 명령용 패키지가 있어 사용자가 HTML 브라우저를 사용하여 man 페이지를 참조할 수 있습니다.groff 및 man-db를 사용하는 시스템에서는 대신 고품질의 네이티브 HTML 출력(man --html)을 사용해야 합니다.GNU Emacs 프로그램 WoMan ("WithOut man"에서)은 [9]편집기에서 man 페이지를 참조할 수 있도록 합니다.

2010년에 OpenBSD는 man page 포맷을 위해 postScript, HTML, XHTML 및 터미널에서 출력을 네이티브로 지원하는 man page 전용 컴파일러/포맷터인 mandoc을 권장하지 않습니다.수동 페이지에서 사용되는 troff의 서브셋, 특히 mdoc 매크로를 사용하는 troff만 지원합니다.

온라인 서비스

많은 웹사이트가 다양한 Unix 계열 시스템의 매뉴얼 페이지에 대한 온라인 액세스를 제공합니다.

2013년 2월 BSD 커뮤니티는 *BSD man 페이지를 [10][11][12]위한 고유한 nginx 기반 결정론적 URL 단축 서비스를 통해 현대 BSD 프로젝트의 man.cgi 스크립트에 대한 액세스를 통합하고 단축하는 새로운 오픈 소스 mdoc.su 서비스를 시작했습니다.

Linux의 경우 [13]man7.org 서비스가 시스템 고유의 매뉴얼을 제공하도록 설정되어 있습니다.ManKier 서비스는 선택의 폭을 넓히고 TLDR 페이지도 [14]통합합니다.

명령어 사용방법

Unix 명령어 매뉴얼페이지를 읽으려면 , 다음과 같이 입력합니다.

man <command_name>

페이지는 일반적으로 "name(섹션)" 표기법을 사용하여 참조됩니다. 예를 들어, 섹션은 시스템 호출, 셸(명령줄) 명령 또는 패키지, 패키지 구성 파일 또는 코딩 구성/헤더와 같은 다양한 토픽을 참조하는 방법을 나타냅니다.

시스템 호출, 사용자 명령 또는 매크로 패키지의 이름이 일치하는 경우 등 매뉴얼의 여러 섹션에 동일한 페이지 이름이 표시될 수 있습니다.예를 들어, 및 , 및 입니다.디폴트 이외의 매뉴얼섹션에 액세스하기 위한 구문은 구현에 따라 다릅니다.

예를 들어 Solaris 및 Illumos에서는 읽기 위한 구문은 다음과 같습니다.

man - s 3c printf

Linux 및 BSD 파생 모델에서는 다음과 같은 호출이 이루어집니다.

man 3 printf

man 페이지의 섹션 3에서 printf를 검색합니다.

수동 섹션

이 매뉴얼은 일반적으로 8개의 섹션으로 나누어져 있으며 다음과 같이 구성되어 있습니다(Research Unix, BSD, macOS 및 Linux).[15][16][17][18]

부분 묘사
1 일반적인 명령어
2 시스템 콜
3 라이브러리 기능, 특히 C 표준 라이브러리를 포함합니다.
4 특수 파일(일반적으로 /dev에 있는 디바이스) 및 드라이버
5 파일 형식 및 규칙
6 게임 및 스크린세이버
7 여러가지 종류의
8 시스템 관리 명령 및 데몬

대부분의 경우 POSIX 시스템콜은 섹션2와 섹션3에 기재되어 있습니다.섹션 2에는 로컬 운영체제시스템으로부터의 시스템콜 매뉴얼이 기재되어 있습니다.섹션 3에는 POSIX 프로그래머 [citation needed]매뉴얼로부터의 시스템콜 매뉴얼이 기재되어 있습니다.

UNIX System V 에서는,[19] 순서가 다른 것을 제외하고, 같은 번호 부여 방식을 사용합니다.

부분 묘사
1 일반적인 명령어
100만 시스템 관리 명령 및 데몬
2 시스템 콜
3 C 라이브러리 함수
4 파일 형식 및 규칙
5 미셀라네아속
6 게임 및 스크린세이버
7 특수 파일(일반적으로 /dev에 있는 디바이스) 및 드라이버

일부 시스템에서는 다음 섹션 중 일부를 사용할 수 있습니다.

부분 묘사
0 C 라이브러리 헤더 파일(Unix v6)
9 커널 루틴(FreeBSD, SVR4, Linux)[18][16]
l LAPACK 라이브러리[20] 함수
n Tcl/Tk 명령어
x X 윈도 시스템

일부 섹션은 접미사에 의해 더욱 세분화됩니다.예를 들어 시스템에 따라 섹션 3C는 C 라이브러리 콜용, 3M은 산술 라이브러리용 등입니다.그 결과 섹션 8(시스템 관리 명령)이 메인 명령 섹션의 1M 하위 섹션으로 밀려날 수 있습니다.일부 서브섹션 접미사는 섹션 전체에서 일반적인 의미를 가집니다.

서브섹션 묘사
p POSIX 사양
x X Window 시스템 매뉴얼

(섹션 3은 언어마다 접미사가 많은 예외인 경향이 있습니다).

의 일부 버전은 마지막으로 본 몇 페이지의 포맷된 버전을 캐시합니다.그 중 하나는 cat 페이지이며, 단순히 호출기에 연결하여 표시할 수 있습니다.

레이아웃

모든 man 페이지는 단순 ASCII 텍스트 디스플레이에 표시되도록 최적화된 공통 레이아웃을 따르며, 강조 표시나 글꼴 제어가 필요하지 않을 수 있습니다.표시되는 섹션은 다음과 같습니다.[21]: MANUAL STRUCTURE

이름.
명령 또는 함수의 이름, 그 뒤에 이어지는 작업에 대한 한 줄의 설명.
개요
명령어의 경우 명령어 실행 방법 및 필요한 명령줄 옵션에 대한 공식적인 설명입니다.프로그램 함수의 경우 함수가 취하는 파라미터와 선언을 포함하는 헤더 파일의 목록입니다.
묘사
명령 또는 함수의 기능에 대한 텍스트 설명입니다.
예
일반적인 용법의 예를 몇 가지 들 수 있습니다.
참고 항목
관련된 명령 또는 기능의 목록입니다.

다른 섹션도 있지만 man 페이지 전체에서 제대로 표준화되지 않았습니다.일반적인 예로는 OPTIONS, EXIT Status, Return Value, Environment, BUGS, FILES, AUTION, BUGS, FILES, AUTHORITION, BUGS, History, Copyright 등이 있습니다.

오서링

매뉴얼 페이지는 이전 버전에서도 쓸 수 있습니다.man매크로, 새로운doc매크로 또는 그 양쪽의 조합(mandoc).[22]man매크로 세트는 제목줄, 섹션 헤더, (굵은 글씨, 작은 글씨 또는 이탤릭체) 글꼴, 단락 및 추가/[23]부호 들여쓰기를 위한 지시문을 포함한 최소한의 리치 텍스트 기능을 제공합니다.새로운 것mdoc언어는 본질적으로 더 의미적이며 프로그램 이름, 개요, 함수 이름 및 작성자 이름과 같은 대부분의 표준 섹션에 대한 전문 매크로를 포함합니다.이 정보는 mandoc과 같은 프로그램에 의한 매뉴얼에 대한 의미 검색을 구현하는 데 사용할 수 있습니다.스타일링을 직접 제어하는 지침도 포함되지만, 전문 매크로가 대부분의 사용 [21]사례를 커버할 것으로 예상됩니다.Mandoc 프로젝트와 Groff 프로젝트 모두mdoc새 [24]문서에 대해 선호하는 형식입니다.

man page는 10개의 로마자로 구성된 텍스트이지만 man page는 종이로 배치되지 않고 터미널(TTY)로 표시되기 때문에 일반적으로 이 구별은 의미가 없습니다.그 결과, 「작은 글꼴」매크로는 [25]거의 사용되지 않습니다.한편, 굵고 이탤릭한 텍스트는 ECMA-48 경유로 단말기에서 지원됩니다.grotty는, 서포트 단말기를 검출했을 때에, 요구에 따라서 송신합니다.다만, BSD mandoc 에서는, 타이프라이터의 backspace-then-overstrike 시퀀스를 개입시켜 굵은 글씨로 밑줄 친 텍스트(이탤릭체 대체)만을 서포트하고 있습니다.이러한 텍스트는 다음에 의해 ECMA-48로 변환되어야 합니다.less를 클릭합니다.[26][27]

man 페이지는 보통 영어로 작성되지만, 다른 언어로 번역할 수도 있습니다.GNUman-db그리고 맨독man는,[28][15]: Overview [16] 서브 디렉토리에서 현지화된 메뉴얼 페이지를 검색하는 것으로 알려져 있습니다.

대체 수단

대신할 수 있는 것이 거의 없다manGNU Project의 "를 제외하고 많은 인기를 누리고 있습니다.info「시스템, 초기 심플한 하이퍼텍스트 시스템입니다.TLDR 페이지라고 불리는 서드파티 작업도 있습니다.tldr일반적인 사용 사례에 대한 간단한 예시를 제공합니다. 이는 [29]치트시트와 유사합니다.

또한 일부 Unix GUI 애플리케이션(특히 GNOME 및 KDE 개발 환경을 사용하여 작성된 애플리케이션)은 최종 사용자 문서를 HTML로 제공하고 다음과 같은 내장 HTML 뷰어를 포함합니다.yelp응용 프로그램의 도움말을 읽을 수 있습니다.

「 」를 참조해 주세요.

레퍼런스

  1. ^ "man(1) — display online manual documentation pages". BSD Cross Reference. FreeBSD. Retrieved 2019-04-01. The man utility finds and displays online manual documentation pages.
  2. ^ a b c McIlroy, M. D. (1987). A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986 (PDF) (Technical report). CSTR. Bell Labs. 139.
  3. ^ a b Darwin, Ian; Collyer, Geoffrey. "UNIX Evolution: 1975-1984 Part I - Diversity". Retrieved 22 December 2012. 1984년 11월, Microsystems 5 (11)에 게재되었습니다.
  4. ^ Fiedler, Ryan (October 1983). "The Unix Tutorial / Part 3: Unix in the Microcomputer Marketplace". BYTE. p. 132. Retrieved 30 January 2015.
  5. ^ "GIT commit 002a6339b1fe8f83f4808022a17e1aa379756d99". Retrieved 22 November 2017.
  6. ^ "GIT commit 84bde8d8a9a357bd372793d25746ac6b49480525". Retrieved 22 November 2017.
  7. ^ "GIT commit b225d9e76fbb0a6a4539c0992fba88c83f0bd37e". Retrieved 25 September 2018.
  8. ^ ""Why does man print "gimme gimme gimme" at 00:30?"". Retrieved 22 November 2017.
  9. ^ Wright, Francis J. "WoMan: Browse Unix Manual Pages "W.O. (without) Man"". GNU. Retrieved 3 August 2020.
  10. ^ Pali, Gabor, ed. (12 May 2013). "FreeBSD Quarterly Status Report, January-March 2013". FreeBSD. Retrieved 25 December 2014.
  11. ^ Murenin, Constantine A. (19 February 2013). "announcing mdoc.su, short manual page URLs". freebsd-doc@freebsd.org (Mailing list). Retrieved 25 December 2014.
  12. ^ Murenin, Constantine A. (23 February 2013). "mdoc.su — Short manual page URLs for FreeBSD, OpenBSD, NetBSD and DragonFly BSD". Retrieved 25 December 2014.
  13. ^ "Linux man pages online". man7.org.
  14. ^ "About". ManKier.
  15. ^ a b man(1) – Linux 일반 명령어 매뉴얼
  16. ^ a b c man(1) – FreeBSD 일반 명령어 매뉴얼
  17. ^ "Manual Pages for Research Unix Eighth Edition". man.cat-v.org.
  18. ^ a b "Unix Programmer's Manual - Introduction". www.bell-labs.com. November 3, 1971.
  19. ^ "System V release 4 manuals". bitsavers.trailing-edge.com.
  20. ^ "lapack (l) - Linux Man Pages". www.systutorials.com. Retrieved 2021-05-29.
  21. ^ a b mdoc(7) – FreeBSD 기타 정보 매뉴얼
  22. ^ groff_tmac(5) – Linux 파일 형식 설명서
  23. ^ man(7) – Linux Miscellanea 매뉴얼
  24. ^ "Groff Mission Statement - 2014". www.gnu.org. Concurrent with work on man(7), mdoc(7) will be actively supported and its use promoted.
  25. ^ "man". The GNU Troff Manual. Retrieved 31 December 2019.
  26. ^ "Italics and colour in manual pages on a nosh user-space virtual terminal". jdebp.eu.
  27. ^ mandoc(1) – FreeBSD 일반 명령어 매뉴얼글꼴 스타일은 백스페이스 인코딩을 사용하여 적용됩니다.."
  28. ^ "command line - Linux man pages in different languages". Ask Ubuntu.
  29. ^ "TLDR pages". tldr.sh.

외부 링크

Wikibook Guide to Unix 에는 다음 항목에 대한 페이지가 있습니다.