Vad är filformatet 1?
.1-filer lagrar Unix-manualsidor i klartextformat, specifikt för sektion 1 - körbara program och användarkommandon. De kallas vanligtvis man-sidor och är skrivna i .roff-markup med makropaketet man (groff), där punkt-prefixade direktiv som .TH, .SH, .B och .TP styr layouten vid rendering.
Man-sidor visas genom att köra man programmets_namn i en Unix-terminal. Sifferändelsen indikerar manualsektionen: .1 täcker användarkommandon, medan .2 till .8 täcker systemanrop, biblioteksfunktioner, filformat, spel respektive administrationskommandon. Alla sektioner delar samma underliggande roff-källformat.
Man-sidfiler kan lagras komprimerade - på de flesta Linux- och macOS-system finns de på sökvägar som /usr/share/man/man1/ls.1.gz och dekomprimeras vid behov av kommandot man. Komprimeringen .gz är osynlig ur användarens perspektiv.
Windows använder ett annat hjälpsystem: i grafiskt läge nås hjälp genom att trycka på F1, och från PowerShell genom att lägga till /? eller -? till ett kommando. För Unix-liknande man-sidor på Windows tillhandahåller Windows Subsystem for Linux (WSL) en fullständig man- och groff-miljö. Givetvis måste man-sidfiler vara installerade för ett givet program innan de kan visas på någon plattform.
Säkerhet & trygghet
RISK: LOWEn man-sidkälla är vanlig text och exekveras inte vid visning. Den enda teoretiska försiktigheten är att roff är ett Turing-komplett makrospråk och groff har historiskt haft buggar i parsningen, så rendering av en .1 från en helt okänd källa görs bäst med den säkrare, sandlåde-baserade mandoc snarare än fullständiga groff. Vid normal användning (läsning av dokumentation från paket och projekt) är en .1-fil ofarlig; att öppna den i en textredigerare är helt säkert.
Formatdetaljer
i ett nötskalProgram som öppnar 1-filer
Tekniska detaljer
djup specifikation| Formattyp | Klartext roff/groff-källa som använder makropaketet man |
| Kodning | ASCII eller UTF-8 klartext; ingen binär header eller BOM krävs |
| MIME-typ | text/troff (accepteras även som application/x-troff-man) |
| Filsignatur | Inga binära magic bytes; man-källor börjar konventionellt med en .TH-titelrad, t.ex. .TH LS 1 |
| Manualsektion som täcks | Sektion 1 - körbara program och allmänna användarkommandon |
| Markup-makron | .TH (titel/header), .SH (sektionsrubrik), .B (fetstil), .I (kursiv), .TP (taggat stycke), .PP (styckebrytning) |
| Lagring på disk | Ofta gzip-komprimerad som namn.1.gz, lagrad under /usr/share/man/man1/ på Linux |
| Typisk okomprimerad storlek | 1 KB - 100 KB |
| Renderare / visare | Bearbetas av groff eller nroff; visas via kommandot man i en terminal |
| Standard sidstruktur | Obligatoriska sektioner: NAME, SYNOPSIS, DESCRIPTION; vanliga tillägg: OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Systersektioner | .2 (systemanrop), .3 (biblioteksfunktioner), .5 (filformat), .8 (systemadministration) |
| Associerade operativsystem | Linux, macOS, BSD-varianter; tillgängligt på Windows via WSL (Windows Subsystem for Linux) |
| Utvecklare / underhållare | Ursprungligen från Bell Labs (1971); groff-implementeringen underhålls av GNU Project |
| Förformaterad variant | Vissa .1-filer är cat-sidor - förrenderad text med backspace-overstrike för fetstil, inte roff-källa |
| Släppt | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Senaste version | N/A (roff/man-macro convention; groff is the active implementation) |
| Öppen standard | Ja · royaltyfri |
| Specifikation | man7.org |
1-konverteringar
Frågor & svar
frågat av användareInga frågor än - bli den första att fråga om 1-filer.