LS(1) Kyttjn sovellusohjelmat LS(1)
ls, dir, vdir - Listaa hakemiston sislln
ls [-abcdfgiklmnpqrstuxABCFGLNQRSUX1] [-w cols] [-T cols] [-I pattern]
[--all] [--escape] [--directory] [--inode] [--kilobytes] [--numeric-
uid-gid] [--no-group] [--hide-control-chars] [--reverse] [--size]
[--width=cols] [--tabsize=cols] [--almost-all] [--ignore-backups]
[--classify] [--file-type] [--full-time] [--ignore=pattern] [--derefer-
ence] [--literal] [--quote-name] [--recursive]
[--sort={none,time,size,extension}] [--format={long,verbose,com-
mas,across,vertical,single-column}]
[--time={atime,access,use,ctime,status}] [--help] [--version]
[--color[={yes,no,tty}]] [--colour[={yes,no,tty}]] [tiedostonimi...]
Tt dokumentaatiota ei en yllpidet, joten se voi olla virheellinen ja
keskenerinen. Nykyn luotettava lhdedokumentaatio on Texinfo.
Tm ohjekirjan sivu dokumentoi ohjelman ls GNU-versiota. dir ja vdir
ovat ls-ohjelman versioita erilaisella tulostusformaatilla. Nm ohjel-
mat listaavat jokaisen annetun tiedosto- tai hakemistonimen. Hakemis-
ton sislt jrjestetn aakkosjrjestykseen. ls listaa tiedostot
sarakkeissa, jrjestettyn vaakasuoraan, jos vakiona tulostetaan
ptteelle; muuten ne listataan yksi per rivi. dir listaa tiedostot ole-
tuksena sarakkeissa, pystysuorassa jrjestettyn. vdir listaa tiedostot
oletuksena pitkss formaatissa.
OPTIOT
-a, --all
Listaa kaikki tiedostot hakemistoissa, mukaanlukien kaikki
tiedostot, jotka alkavat `.'-merkill.
-b, --escape
Nyt tiedostonimien tavalliset merkit normaalisti ja erikois-
merkit C-kielen tapaan oktaaliesitysmuodossa.
-c, --time=ctime, --time=status
Jrjest hakemiston sislt kytten tiedoston tilanvaihtoaikaa muu-
tosajan sijaan. Jos kytetn pitk listausformaattia, tulosta
tilanvaihtoaika muutosajan sijaan.
-d, --directory
Listaa hakemistot, kuten muutkin tiedostot eik niiden sislt.
-f l jrjest hakemiston sislt. Listaa ne siin jrjestyksess, miss ne
ovat levyll. Sama kuin optiot -a ja -U sek optiot -l, -s ja -t
pois plt.
--full-time
Listaa ajat kokonaisina eik kytten normaaleja lyhenteit.
-g Ei huomioida, mukana Unix-yhteensopivuussyist.
-i, --inode
Tulosta tiedoston i-noodin numero ennen tiedostonime.
-k, --kilobytes
Jos tiedostojen koot tulostetaan, ne tulostetaan kilotavuina.
Tm kumoaa ympristomuuttujan POSIXLY_CORRECT.
-l, --format=long, --format=verbose
Jokaisen tiedoston nimen lisksi tulosta tiedoston tyyppi,
oikeudet, linkkien mrt, omistajan nimi, ryhmn nimi, koko tavuina
ja aikaleima (muutosaika ellei muita aikoja ole valittu).
Tiedostoille, jotka ovat enemmn kuin 6 kuukautta vanhoja tai yli
tunnin tulevaisuudessa, aikaleima sislt vuoden, pivnajan sijaan.
-m, --format=commas
Listaa tiedostot vaakasuorassa, niin monta kuin mahtuu riville,
eroteltuna pilkuilla.
-n, --numeric-uid-gid
Listaa numeeriset UID- ja GID-arvot nimien sijasta.
-p Lis tiedoston tyypin ilmaiseva kirjain jokaiseen tiedostonimeen.
-q, --hide-control-chars
Tulosta kysymysmerkit tiedostonimiss erikoismerkkien sijasta.
-r, --reverse
Jrjest hakemiston sislt knteisess jrjestyksess.
-s, --size
Tulosta jokaisen tiedoston koko kilotavun lohkoissa tiedostoni-
men vasemmalla puolella. Jos ympristmuuttujaa POSIXLY_CORRECT
kytetn, nytetn koot 512 tavun lohkoissa.
-t, --sort=time
Jrjest hakemiston sislt aikamerkin mukaan aakkosjrjestyksen
sijaan, uusimmat tiedostot listattuna ensin.
-u, --time=atime, --time=access, --time=use
Jrjest hakemiston sislt kytten tiedostojen viimeist kyttaikaa
muutosajan sijaan. Jos pitk tiedostolistausta on kytetty,
tulosta viimeisin kyttaika muutosajan sijaan.
-x, --format=across, --format=horizontal
Listaa tiedostot sarakkeissa, jrjestetty vaakasuoraan.
-A, --almost-all
Listaa kaikki tiedostot hakemistoina, paitsi `.' ja `..'.
-B, --ignore-backups
l listaa tiedostoja, jotka pttyvt `~', ellei niit ole annettu
komentorivilt.
-C, --format=vertical
Listaa tiedostot sarakkeissa, jrjestetty pystysuorassa.
-F, --classify
Lis tiedoston tyypin ilmaiseva kirjain tiedoston nimeen. Nor-
maaleille tiedostoille, jotka ovat ajettavia, lis `*'. Tiedos-
totyypin merkit ovat `/' hakemistoille, `@' symbolisille
linkeille, `|' FIFO:ille, `=' socket-tiedostoille eik mitn nor-
maaleille tiedostoille.
-G, --no-group
l nyt ryhmn informaatiota, kun kytetn pitk formaattia hakemis-
tolistauksessa.
-L, --dereference
Listaa symboolisten linkkien osoittamat tiedostot linkin sislln
sijaan.
-N, --literal
Nyt erikoismerkit tiedostonimiss.
-Q, --quote-name
Listaa tiedostonimet lainausmerkeiss ja erikoismerkit kuten C-
kieless.
-R, --recursive
Listaa kaikkien hakemistojen sislt rekursiivisesti.
-S, --sort=size
Jrjest hakemiston sislt tiedoston koon mukaan aakkosjrjestyksen
sijaan, suurin tiedosto listattuna ensin.
-U, --sort=none
l jrjest hakemiston sislt; listaa ne siin jrjestyksess, miss ne
ovat levyll. Tm optio ei ole -f koska Unixin ls -f -optio lait-
taa mys plle -a :n ja pois plt optiot -l , -s ja -t. On turhaa
ja rumaa liitt toisiinsa liittymttmt asiat yhteen optioon. Koska
tm optio ei tee sit, sill on eri nimi.
-X, --sort=extension
Jrjest hakemiston sislt aakkosjrjestykseen tiedoston ptteen
mukaan (merkit viimeisen `.'-merkin jlkeen). Tiedostot ilman
ptett listataan ensin.
-1, --format=single-column
Listaa yksi tiedosto rivi kohden.
-w, --width cols
Oleta, ett ruutu on cols merkki leve. Oletus otetaan ptea-
jurista, jos mahdollista, muuten ympristmuuttujasta COLUMNS ,
jos se on asetettu, muuten oletus on 80.
-T, --tabsize cols
Aseta sarkainvliksi cols merkki. Oletus on 8.
-I, --ignore kuvio
l listaa tiedostoja, joiden nimet tsmvt kuvio:on, ellei niit ole
annettu komentorivilt. Kuten komentotulkissa, merkki `.' tiedos-
tonimen alussa est sen sopimisen kuvioon kuvio.
--color, --colour, --color=yes, --colour=yes
Listaa tiedostojen nimet vrillisin tiedoston tyypin mukaan.
Katso TIEDOSTOJEN VRIT alla.
--color=tty, --colour=tty
Sama kuin --color, mutta vain jos vakiotuloste on pte. Tm on
erittin ktev shell-skripteille ja kskyaliaksille etenkin, jos
lukuohjelmasi ei tue vriohjauskoodeja.
--color=no, --colour=no
Vrit pois plt. Tm on oletusarvo. Mahdollisuus kumota edellinen
vrioptio.
--help Tulosta ohje vakiotulosteeseen ja lopeta onnistuneesti.
--version
Tulosta versioinformaatio vakiotulosteeseen ja lopeta onnis-
tuneesti.
TIEDOSTOJEN VRIT
Kun kytetn --color -optiota, tm ls -versio vritt tiedostonimet tiedos-
ton nimen ja tyypin mukaan. Oletuksena vritys tapahtuu vain tyypin
perusteella ja koodit, joita kytetn, ovat ISO 6429 (ANSI) -yhteen-
sopivia.
Voit kumota oletusvrit mrittelemll ympristmuuttujan LS_COLORS (tai
LS_COLOURS). Tmn muuttujan formaatti muistuttaa termcap(5) -tiedosto-
formaattia. Se on kaksoispisteill eroteltu lista arvoista muotoa
"xx=string", miss "xx" on kaksikirjaiminen muuttujan nimi. Muuttujat ja
niiden oletukset ovat:
no 0 Normaali teksti (ei-tiedostonimi)
fi 0 Normaali tiedosto
di 32 Hakemisto
ln 36 Symbolinen linkki
pi 31 Nimetty putki (FIFO)
so 33 Socket
bd 44;37 Lohkolaite
cd 44;37 Merkkilaite
ex 35 Ajettava tiedosto
mi (tyhj) Puuttuva tiedosto (oletuksena fi)
or (tyhj) Roikkuva symbolinen linkki (oletuksena ln)
lc \e[ Vasen koodi
rc m Oikea koodi
ec (tyhj) Lopetus koodi (korvaa lc+no+rc)
Sinun tarvitsee muuttaa vain ne muuttujat, joita haluat muuttaa oletuk-
sesta.
Tiedostonimien vrit voidaan mritt mys tiedostoptteen mukaan. Tm on
mritetty LS_COLORS-muuttujassa kyttmll syntaksia "*ext=string".
Esimerkiksi kyttmll ISO 6429 -koodeja, vrittksesi kaikki C-kielen
lhdekooditiedostot sinisiksi, mrittisit "*.c=34". Tm vrittisi kaikki
tiedostot ptteell .c siniseksi (34).
Ohjausmerkit voidaan kirjoittaa joko C-tyyliin \-merkill suojattuna tai
stty-tyylisen -merkintn. C-tyylisess merkinnss kytetn \e Escapelle, \_
normaalille vlilynnille ja \? poistonppimelle. Lisksi \ suojausmerkki
voidaan kytt kumoamaan merkkien \, ^, : ja = normaali tulkinta.
Jokainen tietue kirjoitetaan <lc> <vrikoodi> <rc> <tiedostonimi> <ec>.
Jos <ec>-koodi on mrittmtn, sarjaa <lc> <no> <rc> kytetn sen sijaan. Tm
on yleenskin ktevmpi kytt, mutta vhemmn yleinen. Vasen, oikea ja lope-
tuskoodi on annettu, joten sinun ei tarvitse kirjoittaa yleisi osia
uudestaan ja tukea outoja ptteit. Sinun ei yleenskn tarvitse vaihtaa
niit ollenkaan paitsi, jos ptteesi kytt muuta kuin ISO 6429 -vrikood-
eja.
Jos ptteesi kytt ISO 6429 -vrikoodeja, voit koota tyyppikoodit (kaikki
muut paitsi lc, rc, ja ec koodit) numeerisista komennoista eroteltuna
puolipisteill. Yleisimmt komennot ovat:
0 palauttaaksesi oletusvrin
1 kirkkaammille vreille
4 alleviivatulle tekstille
5 vilkkuvalle tekstille
30 mustalle etuvrille
31 punaiselle etuvrille
32 vihrelle etuvrille
33 keltaiselle (tai ruskealle) etuvrille
34 siniselle etuvrille
35 violetille etuvrille
36 turkoosille etuvrille
37 valkoiselle (tai harmaalle) etuvrille
40 mustalle taustavrille
41 punaiselle taustavrille
42 vihrelle taustavrille
43 keltaiselle (tai ruskealle) taustavrille
44 siniselle taustavrille
45 violetille taustavrille
46 turkoosille taustavrille
47 valkoiselle (tai harmaalle) taustavrille
Kaikki komennot eivt kuitenkaan toimi kaikilla kokoonpanoilla tai nyt-
nohjaimilla.
Muutama pteohjelma ei tunnista oletuslopetuskoodia oikein. Jos koko
teksti vrittyy tiedostolistauksen jlkeen, kokeile vaihtaa no- ja fi-
vrikoodeja nollasta ptteen omiin vakio etu- ja taustavrien numeerisiin
koodeihin.
BSD jrjestelmiss, -s optio tulostaa HP-UX -jrjestelmien NFS-liitettyjen
tiedostojen koot puolet oikeasta arvosta. HP-UX -jrjestelmiss, BSD-
jrjestelmien NFS-liitettyjen tiedostojen koot ovat puolet suuremmat
kuin oikeat. Tm on johtuu viasta HP-UX:ssa. Se vaikuttaa mys HP-UX:n
ls -ohjelmaan.
Jos olisi yksittinen standardi Englannin kielelle, ei olisi tarpeel-
lista tukea optioiden useita kirjoitusmuotoja.
FSF 22. Toukokuuta 1998 LS(1)