LS(1)

NAMA PERINTAH/PROGRAM
ls, dir, vdir - menampilkan isi direktori

RINGKASAN
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] [--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}]] [nama...]

PENJELASAN
Dokumentasi dan terjemahan mungkin tidak akurat atau tidak lengkap. Mohon koreksi bila ada kesalahan dalam penterjemahan.

Dokumentasi manual page ls versi GNU. dir dan vdir adalah versi-versi dari ls dengan perbedaan default format outputnya. Program-program ini menampilkan daftar nama file atau nama direktori. Isi direktori diurutkan secara alfabet. Untuk ls, secara default nama file ditampilkan dalam kolom-kolom, diurutkan secara vertikal jika standar output-nya adalah terminal; selain itu nama file ditampilkan baris demi baris. Untuk dir, secara default nama file ditampilkan dalam kolom-kolom, diurutkan secara vertikal. Untuk vdir, secara default nama file ditampilkan dalam format panjang.

  OPTION

-a, --all
    Menampilkan seluruh file yang ada dalam direktori, termasuk semua file yang dimulai dengan `.'.

-b, --escape
    Mengutip karakter nongrafik didalam nama file menggunakan huruf alfabet dan rangkaian backslah oktal seperti yang digunakan dalam bahasa C.

-c, --time=ctime, --time=status
    Mengurutkan isi direktori menurut status perubahan waktu file. Bila digunakan format panjang maka status perubahan waktunya juga ditampilkan.

-d, --directory
    Menampilkan nama direktori seperti nama file lainnya.

-f  Isi direktori tidak diurutkan; menampilkan isi direktori menurut urutannya saat disimpan dalam disk. Sama dengan meng-enable-kan option -a dan -U dan men-disable-kan option -l, -s, dan -t.

--full-time
    Menampilkan waktu secara lengkap.

-g  Abaikan; untuk kompatibilitas Unix.

-i, --inode
    Menampilkan nomor indeks setiap file dikiri nama file.

-k, --kilobytes
    Menampilkan file dan ukuran file dalam kilobyte. Untuk menolak variabel environment POSIXLY_CORRECT.

-l, --format=long, --format=verbose
    Menambahkan tampilan setiap file dengan jenis file, permission, jumlah hard link, owner, group, ukuran dalam byte, dan timestamp (waktu perubahan kecuali waktu lain yang dipilih). Untuk file yang umurnya lebih dari 6 bulan atau lebih dari 1 jam, timestamp terdiri dari tahun menggantikan tampilan time saat itu.

-m, --format=commas
    Menampilkan file secara horizontal, setiap nama file dipisahkan dengan tanda koma.

-n, --numeric-uid-gid
    Menampilkan UID dan GID disamping nama filenya.

-p  Menambahkan sebuah karakter pada setiap file untuk menunjukkan tipe filenya.

-q, --hide-control-chars
    Menampilkan tanda tanya.

-r, --reverse
    Mengurutkan isi direktori secara terbalik urutannya.

-s, --size
    Menampilakan besar setiap file berupa blok-blok 1K dikiri nama file. Bila variabel environment POSIXLY_CORRECT di set maka dipakai blok-blok sebesar 512-byte.

-t, --sort=time
    Mengurutkan isi direktori berdasarkan timestamp secara alfabet dengan file terbaru ditampilkan lebih dulu.

-u, --time=atime, --time=access, --time=use
    Mengurutkan isi direktori menurut waktu akses file terakhir kali. Bila format panjang digunakan maka waktu file terakhir yang diakses juga ditampilkan.

-x, --format=across, --format=horizontal
    Menampilkan file dalam kolom, diurutkan secara horizontal.

-A, --almost-all
    Menampilkan semua file dalam direktori, kecuali `.' dan `..'.

-B, --ignore-backups
    Tidak menampilkan file yang berakhir dengan `~', kecuali namanya diberikan pada baris command.

-C, --format=vertical
    Menampilkan file dalam kolom, diurutkan secara vertikal.

-F, --classify
    Menambahkan sebuah karakter pada setiap nama file untuk memberi tanda jenis filenya. Untuk file-file biasa yang bisa di-execute, akan ditandai dengan sebuah karakter `*'. Tanda `/' adalah untuk direktori, `@' untuk symbolic links, `|' untuk FIFO, `=' untuk socket, dan bila tidak ada tambahan apa-apa, menunjukkan file biasa.

-G, --no-group
    Mencegah tampilan informasi group dalam format panjang.

-L, --dereference
    Menampilkan file yang di-link oleh symbolic link.

-N, --literal
    Tidak mengutip nama file.

-Q, --quote-name
    Menyertakan nama file dalam tanda kutip dan mengutip karakter-karakter nongrafik seperti halnya dalam bahasa C.

-R, --recursive
    Menampilkan isi seluruh direktori secara rekursif.

-S, --sort=size
    Mengurutkan isi direktori berdasarkan ukuran secara abjad, dari yang terbesar ukurannya sampai yang terkecil.

-U, --sort=none
    Isi direktori tidak diurutkan; dan menampilkannya sesuai urutan saat disimpan dalam disk. Option ini tidak disebut sebagai -f sebab option ls -f dalam Unix juga meng-enable-kan option -a dan men-disable-kan option -l, -s, dan -t. Rasanya tidak ada gunanya menyatukan semua yang tidak berhubungan itu menjadi satu dalam sebuah option. Selama ini tidak disatukan, option memiliki fungsi berbeda.

-X, --sort=extension
    Mengurutkan isi direktori secara alfabet berdasarkan ekstension-nya (karakter setelah tanda `.' yang terakhir); file-file tanpa ekstension ditempatkan pada urutan pertama.

-1, --format=single-column
    Menampilkan satu file per baris.

-w, --width cols
    Mengasumsikan lebar layar cols kolom. Defaultnya diambil dari terminal driver bila memungkinkan; selain itu variabel environment COLUMNS digunakan jika itu telah di set; selain itu defaultnya adalah 80.

-T, --tabsize cols
    Mengasumsikan setiap tabstop lebarnya cols kolom. Defaultnya adalah 8.

-I, --ignore pattern
    Jangan menampilkan nama file yang mempunyai nama sama dengan shell pattern kecuali nama-nama tersebut diberikan pada baris command. Sebagaimana dalam shell, inisial `.' dalam sebuah nama file tidak sama dengan sebuah wildcard pada awal pattern.

--color, --colour, --color=yes, --colour=yes
    Pemberian warna nama file tergantung jenis file. Lihat PEWARNAAN TAMPILAN dibawah.

--color=tty, --colour=tty
    Sama dengan --color tapi hanya jika standard outputnya adalah terminal. Hal ini sangat berguna untuk shell script dan perintah alias, khususnya jika pager favorit Anda tidak mendukung kode kontrol warna.

--color=no, --colour=no
    Mematikan pewarnaan. Ini adalah defaultnya. Disediakan untuk membatalkan option warna sebelumnya.

--help
    Menampilkan cara penggunaan program atau help.

--version
    Menampilkan informasi versi program.

  PEWARNAAN TAMPILAN
Saat menggunakan option --color versi dari ls akan mewarnai nama file yang ditampilkan sesuai dengan nama dan jenis filenya. Defaultnya, pewarnaan hanya pada jenis filenya dan kode yang digunakan adalah ISO 6429 (ANSI) compliant.

Anda dapat mengabaikan warna default dengan medifinisikan vaiabel environment LS_COLORS (atau LS_COLOURS). Format variabel ini mengingatkan kepada format file termcap(5); titik dua pemisah ekspresi "xx=string", dimana "xx" adalah dua karakter nama variabel. Variabel-variabel default yang berhubungan adalah:

    no       0       Teks Normal (bukan nama-file)
    fi       0       File biasa
    di       32      Direktori
    ln       36      Link symbolic
    pi       31      Pipe (FIFO)
    so       33      Socket
    bd       44;37   Block device
    cd       44;37   Character device
    ex       35      File executable
    mi       (none)  Missing file (default fi)
    or       (none)  Orphanned symbolic link (default ln)
    lc       \e[    Kode Left
    rc       m       Kode Right
    ec       (none)  Kode End (mengganti lc+no+rc)

Anda hanya perlu memasukkan variabel yang Anda inginkan untuk merubah defaultnya.

Nama-nama file juga dapat diwarnai berdasarkan nama ekstensionnya. Sebutkan saja dalam variabel LS_COLORS dengan menggunakan sintaks "*ext=string". Contohnya, menggunakan kode ISO 6429, untuk mewarnai semua file source bahasa C dengan warna biru maka Anda dapat menyebutkannya dengan "*.c=34". Ini akan mewarnai seluruh file yang berakhir .c dengan warna biru (34).

Karakter Control dapat ditulis dengan notasi C-style \-escaped, atau dengan notasi stty-like ^. Notasi C-style menambah \e untuk Escape, \_ untuk karakter space normal, dan \? untuk Delete. Sebagai tambahan, \ karakter escape dapat digunakan untuk menghalangi default \, ^, : and =.

Setiap nama file ditulis sebagai <lc> <color code> <rc> <filename> <ec>. Jika kode <ec> tidak didefinisikan, <lc> <no> <rc> akan digunakan dengan sendirinya. Sebenarnya lebih baik menggunakannya, tapi itu tidak biasa digunakan. Kode-kode left, right dan end juga disediakan sehingga Anda tidak perlu mengetik bagian-bagian yang umum berulang-ulang dan mendukung weird terminals; secara umum Anda tidak perlu mengubahnya sama sekali kecuali terminal Anda tidak menggunakan rangkaian warna ISO 6429.

Jika terminal Anda menggunakan kode warna ISO 6429, Anda dapat membuat kode tipe (semuanya kecuali kode lc, rc, dan ec ) dengan numerik command yang dipisahkan titik koma. Pada umumnya kode-kode tersebut adalah:

     0     kembali ke warna default
     1     warna lebih terang
     4     teks bergaris bawah
     5     teks berkedip
    30     latar belakang hitam
    31     latar depan merah
    32     latar depan hijau
    33     latar depan kuning (atau coklat)
    34     latar depan biru
    35     latar depan ungu
    36     latar depan cyan
    37     latar depan putih (atau abu-abu)
    40     latar belakang hitam
    41     leatar belakang merah
    42     latar belakang hijau
    43     latar belakang kuning (atau coklat)
    44     latar belakang biru
    45     latar belakang ungu
    46     latar belakang cyan
    47     latar belakang putih (atau abu-abu)

Tidak semua kode bisa bekerja pada suatu sistem atau display device.

Pada beberapa program terminal tidak mengenali kode default akhir dengan semestinya. Bila seluruh teks ada warnanya di suatu direktori, cobalah melakukan perubahan pada kode-kode no dan fi dari 0 sampai kode numerik fore- dan warna latar belakang.

BUG
Pada sistem BSD, option -s menghasilkan size separuh dari nilai yang sebenarnya untuk file-file yang di-mount NFS dari sistem HP-UX. Pada sistem HP-UX, menghasilkan size dua kali nilai yang sebenarnya untuk file-file yang di-mount NFS dari sistem BSD. Ini merupakan kekurangan yang harus dibayar HP-UX; juga mempengaruhi program ls HP-UX.

Bila ada sebuah standar tunggal untuk bahasa Inggris maka tidak akan diperlukan dukungan pengejaan yang berlebih.

PENTERJEMAH
Rizqy Syarief <rizqy@rad.net.id>