Man (Unix): differenze tra le versioni

Versione delle 17:43, 23 ago 2013

Versione attuale delle 23:51, 29 dic 2023

(20 versioni intermedie di 11 utenti non mostrate)

Riga 1:

[[File:Unix manual.png|thumb|La pagina man del comando man]]

'''man''' è un comando di cui la maggior parte dei [[sistema operativo|sistemi operativi]] [[Unix|UNIX]] e [[Unix-like]] dispone, per visualizzare le cosiddette ''man pages'' (abbreviazione di "manual pages" ovvero pagine di manuale) ovvero le pagine di manuale, che rappresenta un'ampia documentazione in linea utilizzata dalla quasi totalità delle [[distribuzione GNU/Linux|distribuzioni GNU/Linux]].

== Storia ==

Lo ''UNIX Programmer's Manual'' ("Manuale Unix per Programmatori") fu pubblicato per la prima volta il 3 novembre [[1971]]<ref>{{cita web

|url = http://cm.bell-labs.com/cm/cs/who/dmr/1stEdman.html

|titolo = Unix Programmer's Manual

|accesso = 22-05-2008

|coautori = Ken Thompson; Dennis M. Ritchie

|lingua = en

|data = 3-11-1971

|urlmorto = sì

|urlarchivio = https://web.archive.org/web/20080518013206/http://cm.bell-labs.com/cm/cs/who/dmr/1stEdman.html

|dataarchivio = 18 maggio 2008

}}</ref>. Comunque, le pagine di manuale non furono disponibili in linea fino alla [[Unix|settima edizione di UNIX]] nel [[1979]].

A quel tempo, la disponibilità della documentazione in linea attraverso il sistema delle ''pagine man'' fu considerato come un grande passo avanti. Oggigiorno, virtualmente ogni applicazione Unix a riga di comando è corredata dalla propria ''pagina di man'', e la loro assenza è generalmente percepita come indice di bassa [[qualità del software]]. Alcuni progetti, come [[Debian]], si preoccupano anche di scrivere ''pagine man'' per quei programmi e comandi che ne sono privi.

== Caratteristiche ==

Riga 19 ⟶ 22:

== Localizzazione ==

Le ''pagine man'' sono tipicamente disponibili in [[lingua inglese]], anche se per alcuni sistemi sono disponibili delle traduzioni.

== UtilizzoSintassi ==

Per accedere ad una pagina del manuale si può utilizzare in una [[Shell (informatica)|shell testuale]] il comando

man ''nome_pagina''

ad esempio "<ttkbd>man ftp</ttkbd>".

Tradizionalmente il riferimento ad una ''pagina man'' è espresso usando la notazione "<ttkbd>''nome_pagina''(''sezione'')</ttkbd>", per esempio <ttkbd>ftp(1)</ttkbd> o <ttkbd>socket(2)</ttkbd>.

Lo stesso nome di ''pagina man'' può apparire in più di una sezione del manuale: questo succede quando il nome di una [[chiamata di sistema]], un [[comando (informatica)|comando]] utente o un [[macro package]] hanno lo stesso nome e sono dunque in conflitto tra loro. Due esempi sono <ttkbd>man(1)</ttkbd> e <ttkbd>man(7)</ttkbd>, oppure <ttkbd>exit(1)</ttkbd> ed <ttkbd>exit(3)</ttkbd>.

La sintassi per accedere alle ''pagine man'' di una sezione del manuale che non sia quella predefinita varia tra le differenti implementazioni di ''man'': nella gran parte dei sistemi [[Unix]] e [[Unix-like]], inclusi [[Linux]] ed i vari sistemi [[BSD]], si usa indicare la sezione prima del nome della pagina. Ad esempio la sintassi per leggere la pagina relativa a <ttkbd>printf(3)</ttkbd> è:

man 3 printf

Esiste anche una pagina relativa al comando <ttkbd>man</ttkbd>, visibile tramite il comando <ttkbd>man man</ttkbd>.

== Le sezioni del manuale ==

Riga 52 ⟶ 55:

|-

|4

| File speciali (tipicamente i [[Dispositivo a blocchi|dispositivi a blocchi]] ed i [[Dispositivo a caratteri|dispositivi a caratteri]] che si trovano nella directory <ttkbd>/dev</ttkbd>) e [[driver]]

|-

|5

Riga 88 ⟶ 91:

|}

Le sezioni sono ulteriormente suddivise in sottosezioni usando un suffisso di una lettera, come ad esempio la sottosezione <ttkbd>3C</ttkbd> per le chiamate di libreria C e la sottosezione <ttkbd>3M</ttkbd> per la libreria matematica. Una conseguenza di ciò è che le pagine della sezione 8 (per i comandi di amministrazione del sistema) talvolta rimandano alla sottosezione 1M della sezione dei comandi generali.

Altri suffissi assumono un significato generale tra le sezioni:

Riga 108 ⟶ 111:

* EXAMPLES - Qualche esempio di uso più comune

* SEE ALSO - Una lista di comandi o funzioni simili o ad essi correlati.

Possono essere presenti anche altre sezioni, ma non sono ben standardizzate. Esempi comuni sono: OPTIONS, EXIT STATUS, ENVIRONMENT, KNOWN BUGS, FILES, AUTHOR, REPORTING BUGS ande COPYRIGHT.

== Formato ==

Riga 125 ⟶ 128:

== Voci correlate ==

* [[nroff]]

* [[groff (software)]]

* [[TeX]]

* [[Info (Unix)]]

* [[RTFM]]

== Altri progetti ==

{{interprogetto}}

== Collegamenti esterni ==

* [http{{cita web|https://www.die.net/doc/linux/man/man1/man.1.html |''Linux '''man page''' ]''}}

* [http://www.pluto.it/ildp/man/ Archivi di pagine di manuale in italiano], traduzione ad opera del progetto ILDP, coordinato da [[PLUTO]]

=== Collezioni di pagine man ===

* {{en}}cita [web|http://man.netbsd.org/ |Pagine di manuale di NetBSD]|lingua=en}}

* {{en}}cita [web|1=http://unixhelp.ed.ac.uk/alphabetical/index.html |2=''On-line UNIX manual pages'']|lingua=en|accesso=26 febbraio 2007|urlarchivio=https://web.archive.org/web/20070630173000/http://unixhelp.ed.ac.uk/alphabetical/index.html|dataarchivio=30 giugno 2007|urlmorto=sì}}

* {{en}}cita [web|http://wwwman.linuxmanpageshe.comnet/ |''Linux Man Pages'']|lingua=en}}

* {{en}} [http://manpages.debian.net/cgi-bin/man.cgi Debian Hypertext Man pages], visualizzatore delle pagine man di [[Debian]], molte delle quali disponibili anche in lingua italiana

* {{en}} [http://manpages.unixforum.co.uk/ ''Unix Man Pages / Linux Man Pages''] {{Webarchive|url=https://web.archive.org/web/20070715022130/http://manpages.unixforum.co.uk/ |data=15 luglio 2007 }}, contiene migliaia di pagine man di molte versioni di Unix e di Linux

* {{en}}cita [httpweb|https://www.freebsd.org/cgi/man.cgi |''FreeBSD Hypertext Man Pages'']|lingua=en}}

* {{en}}cita [httpweb|https://www.openbsd.org/cgi-bin/man.cgi |''OpenBSD manual pages'']|lingua=en}}

* {{en}}cita [httpweb|https://leaf.dragonflybsd.org/cgi/web-man |''DragonFlyBSD manual pages'']|lingua=en}}

* {{en}}cita [web|1=http://plan9.bell-labs.com/sys/man/ |2=''Plan 9 Manual — Volume 1'']|lingua=en|accesso=26 febbraio 2007|dataarchivio=29 aprile 2017|urlarchivio=https://web.archive.org/web/20170429122636/http://plan9.bell-labs.com/sys/man/|urlmorto=sì}}

{{Comandi Unix}}

{{Portale|Informatica}}

{{portale|informatica}}

[[Categoria:Unix]]