> Linux Reviews > man >

ls

ls.1.man

1. ls.1.man

Manpage of LS

LS

Section: User Commands (1)
Updated: GNU File Utilities
Index Return to Main Contents

JMÉNO

ls, dir, vdir - vypí¹e obsah adresáøù

POU®ITÍ

ls [-abcdfgiklmnpqrstuxABCFGLNQRSUX1] [-w sloupcù] [-T pozic] [-I vzor] [--all] [--escape] [--directory] [--inode] [--kilobytes] [--numeric-uid-gid] [--no-group] [--hide-control-chars] [--reverse] [--size] [--width=sloupcù] [--tabsize=pozic] [--almost-all] [--ignore-backups] [--classify] [--file-type] [--full-time] [--ignore=vzor] [--dereference] [--literal] [--quote-name] [--recursive] [--sort={none,time,size,extension}] [--format={long,verbose,commas,across,vertical,single-column}] [--time={atime,access,use,ctime,status}] [--help] [--version] [--color[={yes,no,tty}]] [--colour[={yes,no,tty}]] [jméno...]

POPIS

Tato dokumentace není dále udr¾ována a mù¾e být nepøesná nebo neúplná. Autoritativním zdrojem je Texinfo dokumentace.

Tato manuálová stránka popisuje GNU verzi pøíkazu ls. Pøíkazy dir a vdir jsou verze pøíkazu ls s rùznými implicitními výstupními formáty. Tyto programy vypisují v¹echny zadané soubory nebo adresáøe. Obsah adresáøù je abecednì setøídìn. Pøíkaz ls vypisuje implicitnì soubory do sloupcù setøídìných svisle, pokud je standardní výstup na terminál; jinak se vypisuje jeden soubor na øádek. Pøíkaz dir vypisuje implicitnì soubory do sloupcù setøídìných svisle. Pøíkaz vdir vypisuje implicitnì soubory v dlouhém formátu.

VOLBY

-a, --all: Vypí¹e v¹echny soubory v adresáøích vèetnì tìch, jejich¾ jména zaèínají teèkou.
-b, --escape: Netisknutelné znaky ve jménech souborù budou vypsány pomocí øídících posloupností, jaké jsou pou¾ívány v jazyce C.
-c, --time=ctime, --time=status: Obsah adresáøù bude vypsán setøídìnì podle èasu poslední zmìny informací v i-uzlu místo podle èasu poslední zmìny obsahu souboru. Pøi výpisu v dlouhém formátu se místo èasu poslední zmìny souboru vypisuje èas poslední zmìny i-uzlu.
-d, --directory: Vypí¹e informace o zadaných adresáøích nikoli o jejich obsahu.
-f: Nebude vypisovat obsah adresáøù setøídìnì; výpis bude v poøadí, v jakém jsou polo¾ky v adresáøích. Toté¾ jako povolení -a a -U a zakázání -l, -s, a -t.
--full-time: Data a èasy budou vypsány kompletní, nikoli zkrácené, jak je obvyklé.
-g: Ignorováno; pro kompatibilitu s Unixem.
-i, --inode: Bude vypisovat èísla i-uzlù.
-k, --kilobytes: Velikosti souborù budou pøi pou¾ití volby -s, --size vypisovány v kilobytech i kdy¾ je nastavena promìnná prostøedí POSIXLY_CORRECT.
-l, --format=long, --format=verbose: Kromì jména souboru se bude vypisovat jeho typ, práva, poèet pevných odkazù na soubor, jméno vlastníka, skupiny, velikost v bytech a èasový údaj (èas poslední zmìny, pokud nebyl vybrán jiný údaj). U souborù, jejich¾ èasový údaj je star¹í ne¾ 6 mìsícù nebo novìj¹í ne¾ -1 hodina, bude místo hodiny a minuty vypsán rok.
-m, --format=commas: Bude vypisovat jména souborù po øádcích oddìlená èárkami, po tolika, kolik se jich vejde na øádek.
-n, --numeric-uid-gid: Bude vypisovat vlastníka a skupinu (UID a GID) èíselnì.
-p: Za jména souborù pøipojí znak indikující typ souboru.
-q, --hide-control-chars: Bude vypisovat otazníky místo netisknutelných znakù ve jménech souborù.
-r, --reverse: Výpis bude setøídìn v obráceném poøadí.
-s, --size: Bude vypisovat velikost souborù v kilobytech vlevo od jména souboru. Je-li nastavena promìnná prostøedí POSIXLY_CORRECT, bude se velikost souborù vypisovat v 512 bytových blocích.
-t, --sort=time: Setøídí výpis obsahu adresáøe podle èasového údaje a nikoli podle abecedy. Nejnovìj¹í soubory budou vypsány první.
-u, --time=atime, --time=access, --time=use: Výpis souborù bude setøídìn podle èasu posledního pøístupu místo podle èasu posledním zmìny. Pøi dlouhém výpisu se bude vypisovat èas posledního pøístupu místo èasu poslední zmìny.
-x, --format=across, --format=horizontal: Vypisovat soubory do sloupcù tøídìných vodorovnì.
-A, --almost-all: Vypisovat v¹echny soubory v adresáøi kromì `.' a `..'.
-B, --ignore-backups: Nevypisovat soubory, jejich¾ jména konèí `~' pokud nejsou zadána v pøíkazovém øádku.
-C, --format=vertical: Vypisovat soubory do sloupcù tøídìných svisle.
-F, --classify: Za jména souborù pøipojit znak indikující typ souboru. Pro proveditelné soubory znak `*', `/' pro adresáøe, `@' pro symbolické linky, `|' pro pojmenované roury (FIFO), `=' pro sokety, a nic pro normální soubory.
-G, --no-group: Ve dlouhých výpisech nebudou uvedeny informace o skupinì.
-L, --dereference: Vypisovat soubory, na které se odkazují symbolické odkazy, místo odkazù samotných.
-N, --literal: Bude vypisovat speciální znaky ve jménech souborù (nebude je nahrazovat otazníkem).
-Q, --quote-name: Bude vypisovat jména souborù v uvozovkách a netisknutelné znaky bude vypisovat pomocí øídících posloupností, podobnì jako v jazyce C.
-R, --recursive: Vypí¹e obsah v¹ech adresáøù rekurzivnì (vèetnì podadresáøù).
-S, --sort=size: Výpis obsahu adresáøù bude setøídìn podle velikosti souborù (od nejdel¹ích souborù), nikoli abecednì.
-U, --sort=none: Výpis obsahu adresáøù nebude setøídìn; bude v tom poøadí, v jakém jsou polo¾ky v adresáøi. Tato volba není shodná s volbou -f, proto¾e Unixový pøíkaz ls -f také povoluje volbu -a a zakazuje -l, -s, a -t. Zdá se nepou¾itelné a odporné spojovat tyto nesouvisející volby dohromady do jedné volby. Proto bylo pro prostý nesetøídìný výpis pou¾ito jiné jméno volby.
-X, --sort=extension: Výpis obsahu adresáøù bude setøídìn abecednì podle pøípon (znakù za poslední teèkou). Soubory bez pøípony budou první.
-1, --format=single-column: Bude vypisovat jeden soubor na øádku.
-w, --width sloupcù: Pøedpokládá, ¾e obrazovka má zadanou ¹íøku. Implicitní hodnota se bere z ovladaèe terminálu, pokud je mo¾né ji zjistit. Jinak se pou¾ije hodnota promìnné prostøedí COLUMNS, pokud ani ta není nastavena, pou¾ije se 80.
-T, --tabsize pozic: Pøedpokládá, ¾e tabelaèní sloupce jsou ¹iroké cols pozic. Implicitní hodnota je 8.
-I, --ignore vzor: Nebude vypisovat soubory, jejich¾ jména odpovídají zadanému vzoru, pokud nejsou zadána na pøíkazovém øádku. Stejnì jako u shellu, úvodní znak `.' ve jménì souboru nevyhovuje ¾olíkùm na zaèátku vzoru.
--color, --colour, --color=yes, --colour=yes: Vypisuje jména souborù barevnì podle jejich typu. Viz sekce BAREVNÝ VÝSTUP ní¾e.
--color=tty, --colour=tty: Toté¾ jako --color, ale pouze pokud je standardní výstup na terminál. U¾iteèné pro shell skripty a pøíkazové aliasy v pøípadì, ¾e pou¾itý program pro výpis po obrazovkách nepodporuje pøepínání barev.
--color=no, --colour=no: Zaká¾e barevný výstup. Implicitní hodnota. Má význam pro pøebití pøede¹lých voleb.
--help: Vypí¹e návod k pou¾ití na standardní výstup a bezchybnì skonèí.
--version: Vypí¹e èíslo verze na standardní výstup a bezchybnì skonèí.

BAREVNÝ VÝSTUP

Tato verze pøíkazu ls bude pøi pou¾ití volby --color vypisovat jména souborù barevnì podle jejich jména a typu. Implicitnì závisí barva pouze na typu souboru a barevné kódy jsou podle normy ISO 6429 (ANSI).

Implicitní barvy je mo¾né zmìnit pomocí promìnné prostøedí LS_COLORS (nebo LS_COLOURS). Formát hodnoty této promìnné pøipomíná formát souboru termcap(5); jedná se o seznam výrazù ve tvaru "xx=string" oddìlených dvojteèkami, kde "xx" je dvoupísmenné jméno promìnné. Jména promìnných a jejich implicitní hodnoty jsou následující:

no       0       Normální text
fi       0       Obyèejný soubor
di       32      Adresáø
ln       36      Symbolický odkaz
pi       31      Pojmenovaná roura (FIFO)
so       33      Soket
bd       44;37   Blokové zaøízení
cd       44;37   Znakové zaøízení
ex       35      Proveditelný soubor
mi       (nic)   Chybìjící soubor (implicitnì fi)
or       (nic)   Symbolický odkaz do prázdna (implicitnì ln)
lc       \e[     Zahajovací kód (left code)
rc       m       Ukonèovací kód (right code)
ec       (nic)   Kód pro ukonèení barvy (nahrazuje lc+no+rc)

Staèí uvést pouze ty promìnné, které mají mít jinou ne¾ implicitní hodnotu.

Jména souborù se mohou také vypisovat barevnì podle pøípon. Po¾adované barvy lze nastavit promìnnou prostøedí LS_COLORS jako výrazy "*pøípona=øetìzec". Pøi pou¾ití ISO 6429 kódù (tmavì modrá je 34) se budou zdrojové soubory v jazyce C (tj. soubory s pøíponou .c) vypisovat tmavì modrou barvou, pokud LS_COLORS bude obsahovat "*.c=34".

Øídící znaky se mohou zapisovat pomocí escape posloupností zaèínajících znakem \ jako v jazyce C nebo pomocí posloupností zaèínajících znakem ^ jako v pøíkazu stty. Ve stylu podle jazyka C je mo¾né navíc psát \e pro Escape, \_ pro mezeru a \? pro Delete. Znakùm \, ^, : a =, které mají speciální význam, je nutné pøedøadit metaznak \.

Aby pøi pou¾ití nestandardních terminálù nebo pøi dal¹ím zpracování barevného výpisu bylo mo¾né barevné kódy snadno odstranit nebo ignorovat, jsou jména souborù vypisována ve tvaru <lc> <kód barvy> <rc> <jméno souboru> <ec>. Není-li definován kód pro <ec>, bude místo nìj pou¾ita sekvence <lc> <no> <rc>. Tato posloupnost je sice ménì obecná, ale vìt¹inou postaèuje. Kódy <lc> a <rc> je nutné pou¾ívat pouze v pøípadì, ¾e terminál nepodporuje barevné sekvence podle ISO 6429.

Pokud terminál pou¾ívá barevné kódy podle ISO 6429, není nutné definovat kódy pro lc, rc, a ec, a je mo¾né pro jednotlivé typy souborù definovat kódy tvoøené èíselnými hodnotami oddìlenými støedníky. Nejpou¾ívanìj¹í kódy jsou:

 0     implicitní barva
 1     zvý¹ený jas
 4     podtr¾ený text
 5     blikající text
30     èerné písmo
31     èervené písmo
32     zelené písmo
33     ¾luté (nebo hnìdé) písmo
34     tmavì modré písmo
35     purpurové písmo
36     svìtle modré písmo
37     bílé (nebo ¹edé) písmo
40     èerné pozadí
41     èervené pozadí
42     zelené pozadí
43     ¾luté (nebo hnìdé) pozadí
44     tmavì modré pozadí
45     purpurové pozadí
46     svìtle modré pozadí
47     ¾luté (nebo hnìdé) pozadí

Na nìkterých systémech a zobrazovaèích nemusí fungovat v¹echny øídící kódy.

Nìkteré programy správnì nerozpoznají implicitní kód <ec>. Pokud se vypisuje barevný text i po skonèení pøíkazu ls, je tøeba zmìnit kódy no a fi z 0 na èíselné kódy pro standardní barvu písma a pozadí.

CHYBY

V dùsledku chyby v HP-UX, se na BSD systémech pøi pou¾ití volby -s vypisuje pro soubory pøipojené pomocí NFS ze systémù HP-UX polovina správné hodnoty. Naopak, pøíkaz ls na HP-UX systémech vypisuje dvojnásobek správných hodnot pro soubory pøipojené pomocí NFS z BSD systémù.

Pokud by existovala jedna varianta angliètiny, nebylo by nutné podporovat rùzný pravopis nìkterých slov.

Index

JMÉNO

POU®ITÍ

POPIS

VOLBY
BAREVNÝ VÝSTUP

CHYBY

This document was created by man2html using the manual pages.
Time: 17:09:31 GMT, January 19, 2012