Man (Unix): differenze tra le versioni

Versione delle 06:29, 15 ago 2013

Versione attuale delle 23:51, 29 dic 2023

(21 versioni intermedie di 12 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 c.d. 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]]