lsposix - Dalam Talian di Awan

JADUAL:

NAMA

ls — senaraikan kandungan direktori

SINOPSIS

ls [−ikqrs] [−glno] [−A|−a] [−C|−m|−x|−1] \
[−F|−p] [−H|−L] [−R|−d] [−S|−f|−t] [−c|−u] [fail...]

DESCRIPTION

Untuk setiap operan yang menamakan fail jenis selain daripada direktori atau pautan simbolik ke a
direktori, ls hendaklah menulis nama fail serta mana-mana yang diminta, berkaitan
maklumat. Untuk setiap operan yang menamakan fail jenis direktori, ls hendaklah menulis
nama fail yang terkandung dalam direktori serta mana-mana yang diminta, berkaitan
maklumat. Nama fail yang bermula dengan a ('.') dan sebarang maklumat yang berkaitan
tidak boleh ditulis kecuali dirujuk secara eksplisit, the −A or −a pilihan dibekalkan, atau
syarat yang ditentukan pelaksanaan menyebabkannya ditulis. Jika satu atau lebih daripada −d,
−F, Atau −l pilihan ditentukan, dan tidak juga −H tidak juga −L pilihan ditentukan, untuk
setiap operan yang menamakan fail jenis pautan simbolik ke direktori, ls hendaklah menulis
nama fail serta sebarang maklumat berkaitan yang diminta. Jika tiada satu pun −d, −F,
or −l pilihan ditentukan, atau −H or −L pilihan ditentukan, untuk setiap operan itu
menamakan fail jenis pautan simbolik ke direktori, ls hendaklah menulis nama fail
terkandung dalam direktori serta sebarang maklumat berkaitan yang diminta. Dalam setiap
kes di mana nama fail yang terkandung dalam direktori ditulis, jika direktori
mengandungi sebarang pautan simbolik kemudian ls hendaklah menilai maklumat fail dan jenis fail kepada
menjadi pautan simbolik itu sendiri, melainkan jika −L pilihan ditentukan.

Jika tiada operan dinyatakan, ls hendaklah berkelakuan seolah-olah satu operan titik ('.') telah
telah ditentukan. Jika lebih daripada satu operan ditentukan, ls hendaklah menulis bukan direktori
operan dahulu; ia hendaklah menyusun direktori dan operan bukan direktori secara berasingan mengikut
urutan penyusunan dalam tempat semasa.

. ls utiliti hendaklah mengesan gelung tak terhingga; iaitu memasukkan yang telah dilawati sebelum ini
direktori yang merupakan nenek moyang fail terakhir yang ditemui. Apabila ia mengesan yang tidak terhingga
gelung, ls hendaklah menulis mesej diagnostik kepada ralat standard dan hendaklah sama ada memulihkannya
kedudukan dalam hierarki atau tamat.

PILIHAN

. ls utiliti hendaklah mematuhi volum Definisi Asas POSIX.1‐2008, seksyen 12.2,
utiliti Syntax Garis panduan.

Pilihan berikut hendaklah disokong:

−A Tulis semua entri direktori, termasuk yang namanya bermula dengan a
('.') tetapi tidak termasuk entri dot dan dot-dot (jika wujud).

−C Tulis output berbilang teks-lajur dengan entri disusun mengikut lajur, mengikut
kepada urutan penyusunan. Bilangan lajur teks dan pemisah lajur
aksara tidak ditentukan, tetapi harus disesuaikan dengan sifat keluaran
peranti. Pilihan ini melumpuhkan output format panjang.

−F Jangan ikut pautan simbolik yang dinamakan sebagai operan melainkan −H or −L pilihan adalah
ditentukan. Tulis satu ('/') sejurus selepas setiap nama laluan iaitu a
direktori, an ('*') selepas setiap yang boleh dilaksanakan, a
('|') selepas setiap itu ialah FIFO, dan tanda-tanda ('@') selepas setiap itu ialah a
pautan simbolik. Untuk jenis fail lain, simbol lain boleh ditulis.

−H Nilaikan maklumat fail dan jenis fail untuk pautan simbolik yang dinyatakan pada
baris arahan untuk menjadi fail yang dirujuk oleh pautan, dan bukan pautan
sendiri; walau bagaimanapun, ls hendaklah menulis nama pautan itu sendiri dan bukan failnya
dirujuk oleh pautan.

−L Nilaikan maklumat fail dan jenis fail untuk semua pautan simbolik (sama ada
dinamakan pada baris arahan atau ditemui dalam hierarki fail) untuk menjadi yang
fail yang dirujuk oleh pautan, dan bukan pautan itu sendiri; walau bagaimanapun, ls hendaklah menulis
nama pautan itu sendiri dan bukan fail yang dirujuk oleh pautan. Bila −L is
digunakan dengan −l, tulis kandungan pautan simbolik dalam format panjang (lihat
bahagian STDOUT).

−R Senaraikan subdirektori yang ditemui secara rekursif. Apabila pautan simbolik ke direktori
ditemui, direktori tidak boleh disenaraikan secara rekursif melainkan jika −L
pilihan ditentukan. Penggunaan −R bersama −d or −f menghasilkan keputusan yang tidak ditentukan.

−S Isih dengan kunci utama ialah saiz fail (dalam susunan yang berkurangan) dan
kunci sekunder ialah nama fail dalam urutan penyusunan (dalam susunan yang semakin meningkat).

−a Tulis semua entri direktori, termasuk yang namanya bermula dengan a
('.').

−c Gunakan masa pengubahsuaian terakhir maklumat status fail (lihat Pangkalan
Jumlah takrifan POSIX.1‐2008, ) bukannya pengubahsuaian terakhir
daripada fail itu sendiri untuk mengisih (−t) atau menulis (−l).

−d Jangan ikut pautan simbolik yang dinamakan sebagai operan melainkan −H or −L pilihan adalah
ditentukan. Jangan layan direktori secara berbeza daripada jenis fail lain. The
penggunaan −d bersama −R or −f menghasilkan keputusan yang tidak ditentukan.

−f Senaraikan entri dalam operan direktori dalam susunan ia muncul dalam
direktori. Tingkah laku untuk operan bukan direktori tidak ditentukan. Pilihan ini
hendaklah dihidupkan −a. Apabila −f dinyatakan, sebarang kejadian −r, −S, dan −t
pilihan hendaklah diabaikan dan sebarang kejadian −A, −g, −l, −n, −o, dan −s
pilihan mungkin diabaikan. Penggunaan −f bersama −R or −d menghasilkan tidak ditentukan
keputusan.

−g Hidupkan −l (ell) pilihan, tetapi lumpuhkan menulis nama pemilik fail atau
nombor. Lumpuhkan −C, −m, dan −x pilihan.

−i Untuk setiap fail, tulis nombor siri fail fail (lihat stat() dalam Sistem
Isipadu antara muka POSIX.1‐2008).

−k Tetapkan saiz blok untuk −s pilihan dan kiraan blok per-direktori yang ditulis
bagi −l, −n, −s, −g, dan −o pilihan (lihat bahagian STDOUT) hingga 1024 bait.

−l (Huruf ell.) Jangan ikut pautan simbolik yang dinamakan sebagai operan melainkan jika −H
or −L pilihan ditentukan. Tulis dalam format panjang (lihat bahagian STDOUT).
Lumpuhkan −C, −m, dan −x pilihan.

−m Format output aliran; senaraikan nama laluan merentas halaman, dipisahkan dengan a
watak diikuti oleh a watak. Gunakan a watak sebagai senarai
terminator dan selepas urutan pemisah apabila tiada ruang pada baris untuk
entri senarai seterusnya. Pilihan ini melumpuhkan output format panjang.

−n Hidupkan −l (ell) pilihan, tetapi apabila menulis pemilik fail atau kumpulan, tulis
UID berangka fail atau GID dan bukannya nama pengguna atau kumpulan, masing-masing.
Lumpuhkan −C, −m, dan −x pilihan.

−o Hidupkan −l (ell) pilihan, tetapi lumpuhkan menulis nama kumpulan fail atau
nombor. Lumpuhkan −C, −m, dan −x pilihan.

−p Tulis satu ('/') selepas setiap nama fail jika fail itu ialah direktori.

−q Paksa setiap contoh aksara nama fail yang tidak boleh dicetak dan watak ke
ditulis sebagai ('?') watak. Pelaksanaan mungkin menyediakan
pilihan ini secara lalai jika output adalah ke peranti terminal.

−r Balikkan tertib isihan untuk mendapatkan urutan penyusunan terbalik yang tertua dahulu, atau
saiz fail terkecil dahulu bergantung pada pilihan lain yang diberikan.

−s Nyatakan jumlah bilangan blok sistem fail yang digunakan oleh setiap fail yang dipaparkan.
Jika −k pilihan juga ditentukan, saiz blok hendaklah 1024 bait;
jika tidak, saiz blok ditentukan oleh pelaksanaan.

−t Isih dengan kunci utama ialah masa diubah suai (terbaru diubah suai dahulu) dan
kunci sekunder ialah nama fail dalam urutan penyusunan. Untuk simbolik
pautan, masa yang digunakan sebagai kunci isihan ialah pautan simbolik itu sendiri, melainkan
ls sedang menilai maklumat failnya untuk menjadi fail yang dirujuk oleh
pautan (lihat −H and −L pilihan).

−u Gunakan masa akses terakhir (lihat volum Definisi Asas POSIX.1‐2008,
) bukannya pengubahsuaian terakhir fail untuk mengisih (−t) Atau
menulis (−l).

−x Sama seperti −C, kecuali output berbilang teks-lajur dihasilkan dengan
entri diisih merentas, bukannya ke bawah, lajur. Pilihan ini melumpuhkan panjang
output format.

-1 (Digit berangka satu.) Paksa output menjadi satu entri setiap baris. Pilihan ini
tidak melumpuhkan output format panjang. (Output format panjang didayakan oleh −g, −l
(ell), −n, dan −o; dan dilumpuhkan oleh −C, −m, dan −x.)

Jika pilihan yang membolehkan output format panjang (−g, −l (ell), −n, dan −o diberikan dengan
pilihan yang melumpuhkan output format panjang (−C, −m, dan −x), ini tidak boleh dianggap sebagai
ralat. Pilihan terakhir yang dinyatakan ini akan menentukan sama ada output format panjang adalah
bertulis.

If −R, −d, Atau −f ditentukan, hasil menentukan pilihan yang saling eksklusif ini
ditentukan oleh perihalan pilihan ini di atas. Jika lebih daripada satu daripada mana-mana
pilihan lain yang ditunjukkan dalam bahagian SINOPSIS dalam set eksklusif bersama diberikan, ini
tidak boleh dianggap sebagai satu kesilapan; pilihan terakhir yang dinyatakan dalam setiap set hendaklah menentukan
keluarannya.

Perhatikan bahawa jika −t dinyatakan, −c and −u bukan sahaja saling eksklusif antara satu sama lain,
mereka juga saling eksklusif dengan −S semasa menentukan susunan isihan. Tetapi walaupun −S is
dinyatakan selepas semua kejadian −c, −t, dan −u, penggunaan terakhir −c or −u menentukan
cap masa dicetak apabila menghasilkan output format panjang.

OPERAND

Operan berikut hendaklah disokong:

fail Nama laluan bagi fail yang akan ditulis. Jika fail yang dinyatakan tidak dijumpai, a
mesej diagnostik hendaklah dikeluarkan pada ralat standard.

STDIN

Tidak digunakan.

INPUT FILES

Tiada.

PERSEKITARAN PELBAGAI

Pembolehubah persekitaran berikut akan mempengaruhi pelaksanaan ls:

COLUMNS Tentukan lebar kedudukan lajur pilihan pengguna untuk menulis berbilang teks-
keluaran lajur. Jika pembolehubah ini mengandungi rentetan yang mewakili perpuluhan
integer, the ls utiliti hendaklah mengira berapa banyak lajur teks nama laluan untuk ditulis
(Lihat −C) berdasarkan lebar yang disediakan. Jika COLUMNS tidak ditetapkan atau tidak sah, an
bilangan kedudukan lajur yang ditetapkan pelaksanaan hendaklah diandaikan, berdasarkan
pengetahuan pelaksanaan tentang peranti output. Lebar lajur dipilih untuk
tulis nama fail dalam mana-mana direktori tertentu hendaklah tetap. Nama fail
tidak boleh dipotong untuk dimuatkan ke dalam output lajur teks berbilang.

BAHASA Sediakan nilai lalai untuk pembolehubah pengantarabangsaan yang tidak ditetapkan atau
null. (Lihat volum Takrif Asas POSIX.1‐2008, seksyen 8.2,
Pengantarabangsaan Pembolehubah untuk keutamaan pengantarabangsaan
pembolehubah yang digunakan untuk menentukan nilai kategori tempat.)

LC_ALL Jika ditetapkan kepada nilai rentetan bukan kosong, ganti nilai semua yang lain
pembolehubah pengantarabangsaan.

LC_COLLATE
Tentukan tempat untuk maklumat pengumpulan aksara dalam menentukan
jujukan pengumpulan nama laluan.

LC_CTYPE Tentukan tempat untuk tafsiran jujukan bait data teks
sebagai aksara (contohnya, bait tunggal berbanding dengan aksara berbilang bait dalam
argumen) dan aksara mana yang ditakrifkan sebagai boleh dicetak (kelas aksara
cetak).

LC_MESSAGES
Tentukan tempat yang harus digunakan untuk mempengaruhi format dan kandungan
mesej diagnostik yang ditulis kepada ralat standard.

LC_TIME Tentukan format dan kandungan untuk rentetan tarikh dan masa yang ditulis oleh ls.

NLSPATH Tentukan lokasi katalog mesej untuk pemprosesan LC_MESSAGES.

TZ Tentukan zon waktu untuk rentetan tarikh dan masa yang ditulis oleh ls. Jika TZ tidak ditetapkan
atau batal, zon waktu lalai yang tidak ditentukan hendaklah digunakan.

ASYNCRONOUS ACARA

Lalai.

STDOUT

Format lalai hendaklah menyenaraikan satu entri setiap baris ke output standard; pengecualian
adalah ke terminal atau apabila salah satu daripada −C, −m, Atau −x pilihan ditentukan. Jika output adalah
ke terminal, format ditakrifkan pelaksanaan.

Bila −m ditentukan, format yang digunakan untuk elemen terakhir senarai hendaklah:

"%s\n", <nama fail>

Format yang digunakan untuk setiap elemen senarai hendaklah:

"%s,%s", <nama fail>,pemisah>

di mana, jika tiada ruang untuk elemen senarai seterusnya untuk dimuatkan dalam arus
panjang garis,pemisah> ialah rentetan yang mengandungi pilihan watak dan a
wajib watak; jika tidak ia adalah bujang watak.

Jika −i pilihan ditentukan, nombor siri fail fail (lihat Definisi Pangkalan
volum POSIX.1–2008, ) hendaklah ditulis dalam format berikut sebelum sebarang
output lain untuk entri yang sepadan:

%u ", <fail siri nombor>

Jika −l pilihan ditentukan, maklumat berikut hendaklah ditulis untuk fail lain
daripada aksara khas dan sekat fail khas:

"%s %u %s %s %u %s %s\n", <fail mod>,nombor of link>,
<pemilik nama>,kumpulan nama>,saiz>,tarikh and masa>,
<nama jalan>

Jika −l pilihan ditentukan, maklumat berikut hendaklah ditulis untuk watak
khas dan sekat fail khas:

"%s %u %s %s %s %s %s\n", <fail mod>,nombor of link>,
<pemilik nama>,kumpulan nama>,peranti maklumat>,tarikh and masa>,
<nama jalan>

Dalam kedua-dua kes jika fail adalah pautan simbolik dan −L pilihan juga dinyatakan, ini
maklumat hendaklah untuk fail yang diselesaikan daripada pautan simbolik, kecuali bahawa
<nama jalan> medan hendaklah mengandungi nama laluan pautan simbolik itu sendiri. Jika fail adalah a
pautan simbolik dan −L pilihan tidak dinyatakan, maklumat ini hendaklah mengenai pautan
sendiri dannama jalan> medan hendaklah dalam bentuk:

"%s −> %s", <nama jalan of pautan>,kandungan of pautan>

. −n, −g, dan −o pilihan menggunakan format yang sama seperti −l, tetapi dengan item yang ditinggalkan dan mereka
berkaitan watak. Lihat bahagian PILIHAN.

Dalam kedua-dua sebelumnya −l borang, jikapemilik nama> ataukumpulan nama> tidak dapat ditentukan, atau
if −n diberikan, ia hendaklah digantikan dengan nilai angka yang berkaitan dengan menggunakan
format %u.

Thesaiz> medan hendaklah mengandungi nilai yang akan dikembalikan untuk fail dalam
saiz_st bidang struktur stat (lihat volum Takrif Asas POSIX.1‐2008,
). Ambil perhatian bahawa untuk beberapa jenis fail nilai ini tidak ditentukan.

Theperanti maklumat> medan hendaklah mengandungi maklumat yang ditentukan pelaksanaan yang berkaitan dengan
peranti berkenaan.

Thetarikh and masa> medan hendaklah mengandungi tarikh dan cap masa yang sesuai apabila
fail terakhir diubah suai. Dalam tempat POSIX, medan hendaklah setara dengan
keluaran berikut tarikh arahan:

tarikh "+%b %e %H:%M"

jika fail telah diubah suai dalam tempoh enam bulan yang lalu, atau:

tarikh "+%b %e %Y"

(di mana dua aksara digunakan antara %e and %Y) jika fail itu belum
diubah suai dalam enam bulan terakhir atau jika tarikh pengubahsuaian adalah pada masa hadapan, kecuali bahawa,
dalam kedua-dua kes, yang terakhir dihasilkan oleh tarikh tidak boleh dimasukkan dan output
hendaklah seolah-olah tarikh arahan telah dilaksanakan pada masa tarikh pengubahsuaian terakhir bagi
fail dan bukannya masa semasa. Apabila LC_TIME kategori setempat tidak ditetapkan kepada
Tempatan POSIX, format dan susunan pembentangan yang berbeza untuk medan ini boleh digunakan.

Jika nama laluan ditentukan sebagai a fail operan, ia hendaklah ditulis seperti yang dinyatakan.

Mod fail yang ditulis di bawah −l, −n, −g, dan −o pilihan hendaklah terdiri daripada yang berikut
format:

"%c%s%s%s%s", <kemasukan jenis>,pemilik kebenaran>,
<kumpulan kebenaran>,lain kebenaran>,
<pilihan ganti mengakses kaedah bendera>

Thepilihan ganti mengakses kaedah bendera> hendaklah menjadi rentetan kosong jika tiada
kaedah kawalan akses alternatif atau tambahan yang dikaitkan dengan fail; jika tidak, ia
hendaklah menjadi rentetan yang mengandungi satu aksara boleh cetak yang bukan a .

Thekemasukan jenis> aksara hendaklah menerangkan jenis fail, seperti berikut:

d Direktori.

b Sekat fail khas.

c Fail khas aksara.

l (ell) Pautan simbolik.

p FIFO.

− Fail biasa.

Pelaksanaan boleh menambah aksara lain pada senarai ini untuk mewakili pelaksanaan lain-
jenis fail yang ditentukan.

Tiga medan seterusnya hendaklah terdiri daripada tiga aksara setiap satu:

<pemilik kebenaran>
Kebenaran untuk kelas pemilik fail (lihat volum Definisi Asas bagi
POSIX.1–2008, seksyen 4.4, File Mengakses Kebenaran).

<kumpulan kebenaran>
Kebenaran untuk kelas kumpulan fail.

<lain kebenaran>
Kebenaran untuk fail kelas lain.

Setiap medan hendaklah mempunyai tiga kedudukan aksara:

1. Jika 'r', fail boleh dibaca; jika '−', fail tidak boleh dibaca.

2. Jika 'w', fail boleh ditulis; jika '−', fail tidak boleh ditulis.

3. Yang pertama daripada yang berikut yang berkenaan:

S Jika masukpemilik kebenaran>, fail tidak boleh laku dan mod set-user-ID adalah
ditetapkan. Jika dalamkumpulan kebenaran>, fail tidak boleh laku dan mod set-kumpulan-ID
ditetapkan.

s Jika dalampemilik kebenaran>, fail boleh laku dan mod set-user-ID ditetapkan.
Jika dalamkumpulan kebenaran>, fail boleh laku dan mod set-kumpulan-ID ditetapkan.

T Jika masuklain kebenaran> dan fail adalah direktori, kebenaran carian bukan
diberikan kepada orang lain, dan bendera pemadaman terhad ditetapkan.

t Jika masuklain kebenaran> dan fail adalah direktori, kebenaran carian adalah
diberikan kepada orang lain, dan bendera pemadaman terhad ditetapkan.

x Fail boleh laku atau direktori boleh dicari.

− Tiada satu pun daripada sifat-sifat 'S', 's', 'T', 't', Atau 'x' terpakai.

Pelaksanaan boleh menambah aksara lain pada senarai ini untuk aksara ketiga
kedudukan. Penambahan tersebut hendaklah, walau bagaimanapun, ditulis dalam huruf kecil jika fail itu
boleh laksana atau boleh dicari, dan dalam huruf besar jika tidak.

Sekiranya ada −l, −n, −s, −g, Atau −o pilihan ditentukan, setiap senarai fail dalam
direktori hendaklah didahului dengan baris status yang menunjukkan bilangan blok sistem fail
diduduki oleh fail dalam direktori dalam unit 512-bait jika −k pilihan tidak dinyatakan, atau
unit 1024-bait jika −k pilihan ditentukan, dibundarkan ke nombor kamiran seterusnya bagi
unit, jika perlu. Dalam tempat POSIX, format hendaklah:

"jumlah %u\n", <nombor of unit in yang direktori>

Jika lebih daripada satu direktori, atau gabungan fail dan direktori bukan direktori
bertulis, sama ada sebagai hasil daripada menentukan berbilang operan, atau −R pilihan, setiap senarai
fail dalam direktori hendaklah didahului oleh:

"\n%s:\n", <direktori nama>

Jika rentetan ini adalah perkara pertama yang akan ditulis, yang pertama tidak boleh ditulis.
Output ini hendaklah mendahului bilangan unit dalam direktori.

Jika −s pilihan diberikan, setiap fail hendaklah ditulis dengan bilangan blok yang digunakan oleh
fail. Bersama dengan −C, -1, −m, Atau −x, nombor dan a hendaklah mendahului
nama fail; dengan −l, −n, −g, Atau −o, mereka hendaklah mendahului setiap baris yang menerangkan fail.

STDERR

Ralat standard hendaklah digunakan hanya untuk mesej diagnostik.

OUTPUT FILES

Tiada.

EXTENDED DESCRIPTION

Tiada.

EXIT STATUS

Nilai keluar berikut hendaklah dikembalikan:

0 Selesai dengan jayanya.

>0 Ralat telah berlaku.

AKIBAT OF KESALAHAN

Lalai.

. berikutan bahagian adalah bermaklumat.

PERMOHONAN PENGGUNAAN

Banyak pelaksanaan menggunakan ('=') untuk menandakan soket yang terikat pada fail
sistem untuk −F pilihan. Begitu juga, banyak pelaksanaan sejarah menggunakan 's' watak
untuk menandakan soket sebagai aksara jenis kemasukan untuk −l pilihan.

Sukar untuk aplikasi menggunakan setiap bahagian medan mod fail ls −l dalam
cara mudah alih. Jenis fail tertentu dan bit boleh laku tidak dijamin tepat
seperti yang ditunjukkan, kerana pelaksanaan mungkin mempunyai sambungan. Aplikasi boleh menggunakan medan ini untuk lulus
terus kepada cetakan atau gesaan pengguna, tetapi tindakan berdasarkan kandungannya seharusnya secara amnya
ditangguhkan, sebaliknya, kepada ujian utiliti.

Pengeluaran ls (dengan −l dan pilihan yang berkaitan) mengandungi maklumat yang secara logik
boleh digunakan oleh utiliti seperti Chmod and sentuh untuk memulihkan fail kepada keadaan yang diketahui.
Walau bagaimanapun, maklumat ini dibentangkan dalam format yang tidak boleh digunakan secara langsung oleh mereka
utiliti atau mudah diterjemahkan ke dalam format yang boleh digunakan. Satu watak telah
ditambahkan pada penghujung rentetan kebenaran supaya aplikasi sekurang-kurangnya mempunyai
petunjuk bahawa mereka mungkin bekerja di kawasan yang mereka tidak fahami dan bukannya andaian
bahawa mereka boleh menterjemah rentetan kebenaran menjadi sesuatu yang boleh digunakan. masa depan
versi atau dokumen berkaitan boleh menentukan satu atau lebih aksara khusus untuk digunakan berdasarkan
pada mekanisme kawalan akses tambahan atau alternatif standard yang berbeza.

Seperti kebanyakan utiliti yang berurusan dengan nama fail, output daripada ls untuk berbilang
fail atau dalam salah satu format penyenaraian yang panjang mesti digunakan dengan berhati-hati pada sistem di mana
nama fail boleh mengandungi ruang putih terbenam. Pentadbir sistem dan sistem hendaklah
dasar institut dan latihan pengguna untuk mengehadkan penggunaan nama fail tersebut.

Bilangan blok cakera yang diduduki oleh fail yang dilaporkan berbeza-beza bergantung pada
jenis sistem fail asas, unit saiz blok yang dilaporkan, dan kaedah pengiraan
bilangan blok. Pada sesetengah jenis sistem fail, nombor ialah bilangan blok sebenar
diduduki oleh fail (mengira blok tidak langsung dan mengabaikan lubang dalam fail); pada orang lain
ia dikira berdasarkan saiz fail (biasanya membuat elaun untuk blok tidak langsung,
tetapi mengabaikan lubang).

CONTOH

Contoh pokok direktori kecil yang disenaraikan sepenuhnya dengan ls −laRF a dalam POSIX
tempat:

jumlah 11
drwxr-xr-x 3 fox prog 64 julai 4 12:07 ./
drwxrwxrwx 4 fox prog 3264 julai 4 12:09 ../
drwxr-xr-x 2 fox prog 48 julai 4 12:07 b/
-rwxr--r-- 1 fox prog 572 julai 4 12:07 bodoh*

a/b:
Jumlah 4
drwxr-xr-x 2 prog musang 48 Jul 4 12:07 ./
drwxr-xr-x 3 prog musang 64 Jul 4 12:07 ../
-rw-r--r-- 1 prog musang 700 Jul 4 12:07 bar

RATIONALE

Beberapa pelaksanaan sejarah bagi ls utiliti menunjukkan semua entri dalam direktori kecuali
titik dan titik-titik apabila pengguna super memanggil ls tanpa menyatakan −a pilihan. Bila
``biasa'' pengguna memohon ls tanpa menyatakan −a, mereka tidak sepatutnya melihat maklumat tentang
sebarang fail dengan nama yang bermula dengan a melainkan mereka dinamakan sebagai fail operan.

Pelaksanaan dijangka merentasi kedalaman sewenang-wenangnya apabila memproses −R pilihan.
Satu-satunya had pada kedalaman hendaklah berdasarkan kehabisan storan fizikal untuk
menjejaki direktori yang tidak dilalui.

. -1 (satu) pilihan secara sejarah ditemui dalam pelaksanaan BSD dan BSD sahaja. Ia
diperlukan dalam jilid POSIX.1‐2008 ini supaya aplikasi yang mematuhi boleh memastikan
output itu ialah satu entri setiap baris, walaupun outputnya adalah ke terminal.

. −S pilihan telah ditambahkan dalam Isu 7, tetapi telah disediakan oleh beberapa pelaksanaan untuk
bertahun-tahun. Penerangan yang diberikan dalam dokumen standard amalan bersejarah, tetapi tidak
tidak sepadan dengan banyak dokumentasi yang menerangkan tingkah lakunya. Dokumentasi sejarah
biasanya menggambarkannya sebagai sesuatu seperti:

−S Isih mengikut saiz (saiz terbesar dahulu) dan bukannya mengikut nama. Peranti aksara khas
(disenaraikan terakhir) diisih mengikut nama.

walaupun jenis fail tidak pernah dipertimbangkan semasa menyusun output. Watak istimewa
fail biasanya diisih hampir dengan penghujung senarai kerana saiz fail mereka pada kebanyakannya
pelaksanaan adalah sifar. Tetapi mereka diisih mengikut abjad dengan mana-mana fail lain yang
kebetulan mempunyai saiz fail yang sama (sifar), tidak diisih secara berasingan dan ditambah pada penghujung.

Jilid POSIX.1‐2008 ini kerap senyap tentang perkara yang berlaku apabila saling-
pilihan eksklusif ditentukan. Kecuali untuk −R, −d, dan −f, yang ls utiliti diperlukan untuk
terima berbilang pilihan daripada setiap set pilihan yang saling eksklusif tanpa menganggapnya sebagai
ralat dan menggunakan tingkah laku yang ditentukan oleh pilihan terakhir yang diberikan dalam setiap
set eksklusif. Sejak ls adalah salah satu arahan yang paling alias, adalah penting bahawa
pelaksanaan dilaksanakan secara intuitif. Sebagai contoh, jika alias ialah:

alias ls="ls −C"

dan pengguna menaip ls -1 (satu), output lajur-teks tunggal seharusnya terhasil, bukan ralat.

. −g, −l (ell), −n, dan −o pilihan bukan pilihan eksklusif bersama. Mereka semua membolehkan
output format panjang. Mereka bekerjasama untuk menentukan sama ada pemilik fail itu ditulis
(tidak jika −g hadir), kumpulan fail ditulis (tidak jika −o ada), dan jika fail itu
kumpulan atau pemilik ditulis sama ada ia ditulis sebagai nama (lalai) atau rentetan
perwakilan nombor UID atau GID (jika −n hadir). The −C, −m, −x, dan -1 (satu)
adalah pilihan yang saling eksklusif dan tiga yang pertama melumpuhkan output format panjang.
. -1 (satu) pilihan tidak berubah secara langsung sama ada output format panjang didayakan atau tidak,
tetapi dengan mengatasi −C, −m, dan −x, ia boleh mendayakan semula output format panjang yang telah
dilumpuhkan oleh salah satu daripada pilihan ini.

Versi terdahulu piawaian ini tidak menerangkan BSD −A pilihan (seperti −a, tetapi titik dan
titik-titik tidak ditulis). Ia telah ditambah kerana pelaksanaan yang meluas.

Pelaksanaan boleh membuat −q lalai untuk terminal untuk menghalang serangan kuda trojan
terminal dengan urutan pelarian khas. Ini tidak diperlukan kerana:

* Sesetengah aksara kawalan mungkin berguna pada sesetengah terminal; sebagai contoh, sistem mungkin
tulis mereka sebagai "\001" or "^A".

* Tingkah laku khas untuk terminal tidak berkaitan dengan mudah alih aplikasi.

Cadangan awal menyatakan bahawapilihan ganti mengakses kaedah bendera> terpaksa '+'
jika terdapat kaedah capaian ganti yang digunakan pada fail atau jika tiada. ini
telah diubah menjadi jika tidak ada dan satu aksara boleh cetak jika ada.
Ini dilakukan atas tiga sebab:

1. Terdapat pelaksanaan sejarah menggunakan aksara selain daripada '+'.

2. Terdapat pelaksanaan yang mengubah watak ini digunakan dalam kedudukan itu kepada
membezakan antara pelbagai kaedah capaian alternatif yang digunakan.

3. Pembangun standard tidak mahu menghalang spesifikasi masa depan yang mungkin diperlukan
satu cara untuk menentukan lebih daripada satu kaedah capaian alternatif.

Walau bagaimanapun, pelaksanaan yang menyediakan kaedah akses alternatif tunggal adalah digalakkan
penggunaan '+'.

Versi terdahulu piawaian ini tidak mempunyai −k pilihan, yang bermaksud bahawa −s
pilihan tidak boleh digunakan secara mudah alih kerana saiz bloknya ditentukan oleh pelaksanaan, dan
unit yang digunakan untuk menentukan bilangan blok yang diduduki oleh fail dalam direktori dalam ls −l
penyenaraian telah ditetapkan sebagai unit 512-bait. The −k pilihan telah ditambah untuk menyediakan cara untuk
yang −s pilihan untuk digunakan secara mudah alih, dan untuk konsistensi ia juga mengubah perkara yang disebutkan di atas
unit daripada 512-bait hingga 1024-bait.

Thetarikh and masa> medan dalam −l format ditentukan hanya untuk tempat POSIX. Sebagai
ambil perhatian, format boleh berbeza di tempat lain. Tiada mekanisme untuk menentukan ini
terdapat dalam jilid POSIX.1‐2008 ini, kerana kenderaan yang sesuai ialah sistem pemesejan;
iaitu format hendaklah dinyatakan sebagai ``mesej''.

MASA HADAPAN ARAHAN

Membenarkan −f untuk mengabaikan −A, −g, −l, −n, −o, dan −s pilihan boleh dialih keluar pada masa hadapan
versi.

Gunakan lsposix dalam talian menggunakan perkhidmatan onworks.net