| Nykyinen versio |
Oma tekstisi |
| Rivi 1: |
Rivi 1: |
| {{DISPLAYTITLE:{{lcfirst:{{PAGENAME}}}}}}
| | Ls on komentorivikomento, jolla listataan [[Hakemisto|hakemiston]] sisältämät tiedostot. |
| '''ls''' on [[komentorivi|komentorivikomento]], jolla listataan [[hakemisto]]n sisältämät [[tiedosto]]t.
| |
| | |
| Komento '''dir''' on sama kuin <tt>ls -Cb</tt> ja '''vdir''' on sama kuin <tt>ls -lb</tt>.
| |
|
| |
|
| ==Käyttö== | | ==Käyttö== |
| Listaa hakemiston sisältämät tiedostot (pelkät tiedostonimet)
| |
| ls
| |
| Listaa nykyisen hakemiston kaikki tiedostot, jotka alkavat kirjaimilla "tied"
| |
| ls tied*
| |
| Listaa kaikki tiedostot (myöskin piilotiedostot)
| |
| ls -a | | ls -a |
| Listaa kaikki lukuunottamatta piilotiedostoja "." ja ".." (<tt>.</tt>=nykyinen hakemisto, <tt>..</tt>=ylähakemisto) | | Listaa kaikki tiedostot (myöskin piilotiedostot). |
| ls -A | | ls -A |
| Listaa tiedostokoot | | Listaa kaikki lukuunottamatta piilotiedostoja "." ja ".." |
| ls -s | | ls -s |
| Näyttää tiedostokoot helpossa muodossa käyttäen k-, M-, G- ja T-etuliitteitä (voidaan käyttää myös [[valitsin|valitsimen]] <tt>-l</tt> kanssa) | | Listaa oikeudet, omistajat, tiedostokoot sekä muokkauspäivämäärät. |
| ls -hs
| | ls -l |
| Listaa alihakemistot rekursiivisesti, ts näyttää kaikkien alihakemistojen ja niiden alihakemistojen sisällöt
| | Listaa myös oikeudet. |
| | ls -h |
| | Näyttää tiedostokoot helpossa muodossa käyttäen k-, M-, G- ja T-etuliitteitä. |
| ls -R | | ls -R |
| Listaa hp-alkuiset tiedostot näyttämättä mahdollisten tällä nimellä alkavien alihakemistojen sisältöä | | Listaa alihakemistot rekursiivisesti. |
| ls -d hp* | | ls tied* |
| Listaa tiedostot koon mukaisessa järjestyksessä. [[Hakemisto]]ista ei näytetä niiden sisällön kokoa, vaan vain itse hakemistotiedoston koko. Hakemistojen sisällön koon voi halutessaan laskea komennolla [[du]]. | | Listaa nykyisen kansion kaikki tiedostot, jotka alkavat kirjaimilla "tied". |
| | ls -d |
| | Ei listaa alihakemistojen sisältöä. |
| ls -S | | ls -S |
| | Listaa tiedostokoon mukaisessa järjestyksessä. |
|
| |
|
| ===Pitkä tulostusmuoto===
| | [[Luokka:Komentorivi]] |
| Listaa hakemiston tiedostot pitkässä muodossa
| |
| ls -l
| |
| jolloin tulos voisi näyttää vaikkapa seuraavalta:
| |
| yhteensä 4
| |
| -rw-r--r-- 1 root root 774 18 sep 2007 inputrc
| |
| -rw-r--r-- 1 root root 40 26 okt 2007 issue
| |
| lrwxrwxrwx 1 root root 10 24 okt 18.32 psaux -> misc/psaux
| |
| drwxr-xr-x 2 root root 0 24 okt 18.32 pts
| |
| | |
| Ensimmäisellä rivillä näytetään listattavien tiedostojen kokonaismäärä.
| |
| | |
| Muiden rivien ensimmäinen merkki määrittää tiedostotyypin. '''-''' tarkoittaa tavallista [[tiedosto]]a, '''d''' [[hakemisto]]a, '''l''' [[symbolinen linkki|symbolista linkkiä]], '''p''' [[nimetty putki|nimettyä putkea]], '''s''' [[wikipedia:Unix domain socket|socket]]ia, '''b''' lohkolaitetta (engl. ''block device'', tietyn merkkilohkon kerrallaan lukeva [[laitetiedosto]]) ja '''c''' merkkilaitetta (engl. ''character device'', yksittäisiä merkkejä lukeva laitetiedosto).
| |
| | |
| Sitä seuraavat merkit kertovat [[tiedoston oikeudet]]. Merkit 1-3 luettelevat tiedoston omistavan [[käyttäjä]]n oikeudet, 4-6 omistaja[[ryhmä]]n oikeudet ja 7-9 ulkopuolisten oikeudet. '''r''' tarkoittaa lukuoikeutta, '''w''' kirjoitusoikeutta ja '''x''' suoritusoikeutta. Jos tiedoston setuid-bitti on päällä, näkyy kentässä 3 '''S'''-kirjain. Jos setgid-bitti on päällä, näkyy S-kirjain kentässä 6. Mikäli näissä kentissä muuten olisi x-kirjain, näkyy '''s'''-kirjain pienenä. Jos tiedostolle on asetettu sticky bit (tahmabitti), näkyy listauksessa vielä kymmenes kenttä, jossa on iso '''T'''-kirjain.
| |
| | |
| Oikeuksien jälkeen näkyvä numero ilmaisee tiedostoon osoittavien [[kova linkki|kovien linkkien]] määrän. Hakemistoilla niitä on aina vähintään kaksi, toinen kova linkki on hakemiston sisältämä <tt>..</tt>-tiedosto.
| |
| | |
| Tämän jälkeen näkyvät tiedoston omistava [[käyttäjä]] sekä omistaja[[ryhmä]]. Jos [[UID]]- ja [[GID]]-numeroita vastaavia käyttäjiä tai ryhmiä ei löydy järjestelmästä, näytetään nimen sijaan UID- tai GID-numero.
| |
| | |
| Tämän jälkeen näkyy tiedoston koko lohkoina. Koon saa näkymään ihmisystävällisemmässä muodossa valitsimella <tt>-h</tt>, eli esimerkiksi <tt>ls -lh</tt>.
| |
| | |
| Seuraavaksi näkyy tiedoston muokkausajankohta eli [[mtime]]. Ensimmäisenä päivä, sitten kuukausi ja lopuksi kellonaika tai vuosi riippuen siitä, onko tiedostoa muokattu kyseisenä vuonna.
| |
| | |
| Viimeisenä näkyy tiedostonnimi ja '''->'''-merkkien jälkeen symbolisen linkin kohde, jos tiedosto on symbolinen linkki.
| |
| | |
| ===Värit===
| |
| Näytetään tiedostonnimet eri väreillä riippuen tiedoston tyypistä ja oikeuksista:
| |
| ls --color=auto
| |
| Yleensä tämä on valmiiksi asetettu ls:n [[alias|aliakseksi]]. Color-valitsin tottelee <tt>auto</tt>n ohella myös määreitä <tt>never</tt> ja <tt>always</tt>. Always eroaa autosta siinä, että tulostukseen lisätään värikoodit myös siinä tapauksessa, ettei tulostusta ohjata [[konsoli]]in (näytölle), vaan esimerkiksi putkitetaan toiselle ohjelmalle, joka ei välttämättä värikoodeja ymmärrä (useimmissa järjestelmissä esimerkiksi [[less]]).
| |
| | |
| Käytettävien värikoodien asettamiseen käytetään [[ympäristömuuttuja]]a <tt>LS_COLORS</tt>. Väriasetusten määrittämistä helpottamaan on tehty [[dircolors]]-ohjelma.
| |
| | |
| ==Valitsimia==
| |
| *'''-a''' - näyttää kaikki tiedostot (mukaan lukien erikoistiedostot <tt>.</tt> ja <tt>..</tt>)
| |
| *'''-A''' - näyttää kaikki tiedostot paitsi <tt>.</tt>:n ja <tt>..</tt>:n
| |
| *'''--author''' - valitsimen <tt>-l</tt> kanssa käytettynä näyttää omistajaryhmän nimen ja tiedostokoon välissä tiedoston tekijän nimen (muualla kuin [[GNU Hurd]]issa sama kuin tiedoston omistaja)
| |
| *'''-b''' - näyttää tiedostojen ei-graafiset merkit oktaalisina koodeina
| |
| *'''--block-size=''' - määrittää tiedoston koon näyttämisessä käytettävän lohkokoon [http://www.gnu.org/software/coreutils/manual/html_node/Block-size.html]
| |
| *'''-B''' - ei näytä [[varmuuskopio]]tiedostoja, eli tiedostoja, jotka alkavat merkillä <tt>~</tt>
| |
| *'''-c''' - valitsinyhdistelmän <tt>-lt</tt> kanssa näyttää tiedostojen [[ctime]]n ja järjestää sen mukaan, valitsimen <tt>-l</tt> kanssa käytettynä näyttää mtimen sijasta ctimen
| |
| *'''-C''' - käytettäessä lyhyttä muotoa järjestää tulosteen sarakkeisiin (oletus)
| |
| *'''--color=''' - väriasetus, ks yllä
| |
| *'''-d''' - näyttää hakemistojen sisällön sijasta niiden omat tiedot, eikä seuraa komentorivillä määriteltyjä symbolisia linkkejä, jollei valitsimia <tt>-H</tt>, <tt>-L</tt> tai <tt>--dereference-command-line-symlink-to-dir</tt> ole määritelty
| |
| *'''-D''' - sovittaa tulosteen [[Emacs]]in dired-tilaa varten
| |
| *'''-f''' - sama kuin <tt>-aU --color=never</tt>, kumoaa myös mahdolliset tätä ennen annetut <tt>-l</tt>- ja <tt>-s</tt>-valitsimet
| |
| *'''-F''' - lisää tiedostonnimien perään merkin ''*'' kuvaamaan suoritusoikeutta, merkin ''/'' kuvaamaan hakemistoja, merkin ''@'' kuvaamaan symbolisia linkkejä, merkin ''|'' kuvaamaan nimettyjä putkia ja merkin ''='' kuvaamaan socketeja
| |
| *'''--file-type''' - sama kuin <tt>-F</tt>, mutta ei lisätä *-merkkejä
| |
| *'''--format=''' - listauksen muoto, ''across'' on sama kuin <tt>-x</tt>, ''commas'' on sama kuin <tt>-m</tt>, ''horizontal'' on sama kuin <tt>-x</tt>, ''long'' on sama kuin <tt>-l</tt>, ''single-column'' on sama kuin <tt>-1</tt>, ''verbose'' on sama kuin <tt>-l</tt> ja ''vertical'' on sama kuin <tt>-C</tt>
| |
| *'''--full-time''' - sama kuin <tt>-l --time-style=full-iso</tt>
| |
| *'''-g''' - sama kuin <tt>-l</tt>, mutta ei näytä tiedoston omistajaa
| |
| *'''--group-directories-first''' - näyttää hakemistot listauksessa ensimmäisinä, kumoutuu valitsimilla <tt>--sort=none</tt> ja <tt>-u</tt>
| |
| *'''-G''' - ei näytä pitkässä muodossa ryhmien nimiä
| |
| *'''-h''' - näyttää tiedostojen koot lohkojen sijasta kilo-, mega- tai gigatavuina jne
| |
| *'''--si''' - sama kuin <tt>-h</tt>, mutta käyttää kertoimena 1024:n sijasta 1000:ta
| |
| *'''-H''' - seuraa komentoriviltä määriteltyjä symbolisia linkkejä
| |
| *'''--dereference-command-line-symlink-to-dir''' - seuraa komentoriviltä määriteltyjä, hakemistoihin osoittavia symbolisia linkkejä
| |
| *'''--hide=''' - ei näytä määriteltyyn komentorivilausekkeeseen (esim <tt>*.ogg</tt>) sopivia tiedostoja, voidaan ohittaa valitsimilla <tt>-a</tt> ja <tt>-A</tt>
| |
| *'''--indicator-style=''' - määrittää, mitä tiedoston tyyppiä tai oikeuksia kuvaavia erikoismerkkejä sen nimeen lisätään, ''none'' tarkoittaa ei mitään, ''slash'' on sama kuin valitsin <tt>-p</tt>, ''file-type'' sama kuin <tt>--file-type</tt> ja ''classify'' sama kuin <tt>-F</tt>
| |
| *'''-i''' - tulostaa tiedoston [[i-node]]-numeron
| |
| *'''-I''' - ei näytä määriteltyyn komentorivilausekkeeseen (esim <tt>*.ogg</tt>) sopivia tiedostoja
| |
| *'''-k''' - sama kuin <tt>--block-size=1K</tt>
| |
| *'''-l''' - käyttää pitkää muotoa (ks yllä)
| |
| *'''-L''' - seuraa aina symbolisia linkkejä, ts näyttää linkin kohteen tiedot itse linkkitiedoston sijasta
| |
| *'''-m''' - näyttää tulosteen pilkuilla eroteltuna
| |
| *'''-n''' - sama kuin <tt>-l</tt>, mutta näyttää omistajien ja ryhmien nimien sijasta niiden [[UID]]- ja [[GID]]-numerot
| |
| *'''-N''' - näyttää tiedot raa'assa muodossa, soveltamatta ohjausmerkkejä
| |
| *'''-o''' - sama kuin <tt>-l</tt>, mutta ei näytä omistajaryhmän nimeä
| |
| *'''-p''' - lisää hakemistojen nimen perään ''/''-merkin
| |
| *'''-q''' - tulostaa ei-graafisten merkkien kohdalla kysymysmerkin
| |
| *'''--show-control-chars''' - näyttää ei-graafiset merkit sinällään
| |
| *'''-Q''' - lisää tiedostonnimien ympärille lainausmerkit
| |
| *'''--quoting-style=''' - määrittelee tiedostonnimien ja muiden merkkijonojen, jotka voivat sisältää ei-graafisia merkkejä, käsittelyn [http://www.gnu.org/software/coreutils/manual/html_node/Formatting-the-file-names.html]; ''literal'' on sama kuin valitsin <tt>-N</tt>, ''shell'' lisää lainausmerkit [[POSIX]]-sukuisten [[komentotulkki]]en erikoismerkeiksi tulkitsemien merkkien ympärille, ''shell-always'' lisää aina lainausmerkit, ''c'' sama kuin valitsin <tt>-Q</tt>, ''escape'' on sama kuin valitsin <tt>-b</tt>, ''clocale'' sama kuin valitsin <tt>-Q</tt> mutta sovittaa lainausmerkit [[lokalisointi]]in, ''locale'' sama kuin edellä, mutta C-lokaalilla käyttää `tällaisia' lainausmerkkejä "tämänlaisten" sijaan
| |
| *'''-r''' - näyttää tulosteen käänteisessä järjestyksessä
| |
| *'''-R''' - rekursiivinen tulostus, tulostaa myös kaikkien alihakemistojen ja niiden alihakemistojen sisällön
| |
| *'''-s''' - näyttää tiedostojen koot (oletuksena lohkoina)
| |
| *'''-S''' - järjestää tiedostot tiedostokoon mukaan
| |
| *'''--sort=''' - määrittää tiedostojen järjestelyn, ''none'' on sama kuin valitsin <tt>-U</tt>, ''extension'' sama kuin <tt>-X</tt>, ''size'' sama kuin <tt>-S</tt>, ''time'' sama kuin <tt>-t</tt> ja ''version'' sama kuin <tt>-v</tt>
| |
| *'''--time=''' - määrittää, mikä aika näytetään pitkässä muodossa, ''atime'' on sama kuin valitsin <tt>-u</tt>, ''access'' sama kuin <tt>-u</tt>, ''use'' sama kuin <tt>-u</tt>, ''ctime'' sama kuin <tt>-c</tt> ja ''status'' sama kuin <tt>-c</tt>, yhdessä <tt>--sort</tt>-valitsimen kanssa järjestää listan määritellyn aikaleiman mukaan
| |
| *'''--time-style=''' - määrittelee ajan esittämisen muodon [http://www.gnu.org/software/coreutils/manual/html_node/Formatting-file-timestamps.html]
| |
| *'''-t''' - järjestää muokkausajankohdan ([[mtime]]) mukaan
| |
| *'''-T''' - tabulaattorin (sarkaimen) pituus, oletuksena 8 merkkiä
| |
| *'''-u''' - valitsinyhdistelmän <tt>-lt</tt> kanssa näyttää tiedostojen [[atime]]n ja järjestää sen mukaan, valitsimen <tt>-l</tt> kanssa käytettynä näyttää mtimen sijasta atimen
| |
| *'''-U''' - ei järjestä tiedostoja, luettelee ne siinä järjestyksessä kuin ne ovat hakemistossa
| |
| *'''-v''' - järjestää version mukaan, eli tulkitsee tiedostonnimien numerojonot numerosisältönsä mukaan [http://www.gnu.org/software/coreutils/manual/html_node/More-details-about-version-sort.html]
| |
| *'''-w''' - itsemääritelty arvo ruudun ([[pääte]]ikkunan) leveydelle
| |
| *'''-x''' - näyttää tulosteen sarakkeiden sijasta riveinä
| |
| *'''-X''' - järjestää tiedostot aakkosellisesti tiedostopäätteen (viimeisen pisteen jälkeinen merkkijono) mukaan, päätteettömät tiedostot luetellaan ensin
| |
| *'''-Z''' - tulostaa [[SELinux]]in turvallisuustietoja
| |
| *'''-1''' - näyttää yhden tiedoston per rivi
| |
| | |
| ==Katso myös==
| |
| *[[Tree]]
| |
| *[[Lsattr]]
| |
| *[[Du]]
| |
| *[[Find]]
| |
| | |
| [[Luokka:Coreutils]]
| |
| [[Luokka:Komentorivin perustyökalut]] | |
| | |
| [[pl:Ls]]
| |