List
| Formát: | LIST [{<adresář|maska>}] [P|PAT <maska>] [KEYS] [DATES] [NODATES] [TO <soubor>] [SUB <řetězec>] [SINCE <datum>] [UPTO <datum>] [QUICK] [BLOCK] [NOHEAD] [FILES] [DIRS] [LFORMAT <řetězec>] [SORT [NAME] [SIZE] [DATE] [REVERSENAME] [REVERSESIZE] [REVERSEDATE]] [USERS] [GROUPS] [MULTI] [ALL] |
| Šablona: | DIR/M, P=PAT/K, KEYS/S, DATES/S, NODATES/S, TO/K, SUB/K, SINCE/K, UPTO/K, QUICK/S, BLOCK/S, NOHEAD/S, FILES/S, DIRS/S, LFORMAT/K, SORT/K, USERS/S, GROUPS/S, MULTI/S, ALL/S |
| Účel: | Vypisuje podrobnější údaje o souborech a adresářích |
| Cesta: | C:LIST |
Příkaz LIST vypisuje informace o adresářích a souborech. Je dosti podobný příkazu DIR, ten však zobrazuje pouze jména souborů a adresářů, kdežto příkaz LIST může zobrazit všechny základní vlastnosti adresářů a souborů.
LIST bez argumentů zobrazí obsah aktuálního adresáře. Když zadáte adresář, zobrazí se informace o obsahu tohoto adresáře. Zadat můžete též soubor, pak se zobrazí informace pro daný soubor. Pochopitelně můžete použít též masku.
Pokud neurčíte jinak, příkaz LIST zobrazí následující údaje: jméno souboru nebo adresáře; velikost souboru v bytech; pro adresáře se místo toho zobrazí údaj "Dir"; stavové bity, nastavené bity se zobrazí svým písmenem, bity smazané jako pomlčky; datum a čas vytvoření nebo poslední změny adresáře či souboru; komentář adresáře nebo souboru, uvozený středníkem (;).
Příkaz LIST patří, co se formátu týče, k nejsložitějším. Nabízí spoustu voleb, jimiž můžete měnit formát výstupu:
| Volba | Popis |
|---|---|
| KEYS: | Zobrazí čísla bloků, v nichž je uloženy hlavičky jednotlivých souborů a adresářů (takzvané klíčové bloky). |
| DATES: | Zobrazí data ve formátu DD-MMM-RR (implicitní formát, pokud neužijete volbu QUICK). |
| NODATES: | Nebude se zobrazovat datum a čas. |
| TO <soubor>: | Nastaví soubor nebo zařízení (třeba tiskárnu), do něhož bude přesměrován výstup. Implicitně příkaz LIST píše na obrazovku. |
| SUB <řetězec>: | Zobrazí pouze soubory, v nichž je obsažen zadaný <řetězec>. |
| SINCE <datum>: | Zobrazí pouze soubory vytvořené nebo změněné od zadaného data. |
| UPTO <datum>: | Zobrazí pouze soubory vytvořené nebo změněné do zadaného data. |
| QUICK: | Zobrazí pouze jména souborů a adresářů (jako příkaz DIR). |
| BLOCK: | Velikosti souborů budou místo v bytech udávány v blocích. |
| NOHEAD: | Potlačí ve výstupu výpis hlavičky. |
| FILES: | Zobrazí se pouze soubory, případné adresáře nikoli. |
| DIRS: | Zobrazí se jen adresáře, zobrazení souborů bude potlačeno. |
| LFORMAT: | Definuje řetězec formátující výstup příkazu. |
| ALL: | Příkaz zobrazí všechny soubory a podadresáře zadaného nebo aktuálního adresáře. |
Na volbu LFORMAT je třeba podívat se podrobněji. Tato volba určuje, jak bude výstup příkazu LIST vypadat. Formát výstupu nastavuje formátovací řetězec obsahující speciální kódy. Kromě nich tam může být i normální text, ten se do výstupu prostě zkopíruje.
Pro formátování výstupu můžete použít následující kódy:
| Kód | Popis |
|---|---|
| %A | Zobrazí atributy souborů a adresářů (stavové bity). |
| %B | Zobrazí velikosti souborů jako počty bloků. |
| %C | Zobrazí komentáře adresářů a souborů (existují-li). |
| %D | Zobrazí datum souboru nebo adresáře. |
| %K | Zobrazí klíčové bloky souborů a adresářů. |
| %L | Zobrazí velikosti souborů jako počty bytů. |
| %N | Zobrazí jména souborů a adresářů. |
| %P | Zobrazí cestu adresářů a souborů (pokud se nejedná o kořenový adresář). |
| %S | "Substituční" kód (viz níže). |
| %T | Zobrazí čas souborů a adresářů. |
Kód "%S" představuje ve výstupu příkazu LIST buď jména souborů, nebo jejich cesty, podle svého umístění ve formátovacím řetězci. Jde o to, kolikátý výskyt kódu to je a kolik jich tam je celkem:
| Výskyt kódu %S | |||
|---|---|---|---|
| 1. | 2. | 3. | 4. |
| 1 | jméno | ||
| 2 | cesta | jméno | |
| 3 | cesta | jméno | jméno |
| 4 | cesta | jméno | cesta jméno |
Mezi znak "%" a vlastní písmeno formátovacího kódu můžete zadat číslo nastavující počet míst (znaků), případně i symboly pro zarovnání (nejdůležitější symbol pro zarovnání je znaménko mínus (-), které nastavuje zarovnání na levý okraj, implicitně se vyrovnává na pravý okraj).
Argument LFORMAT se dá použít k rychlé tvorbě dávkových souborů. Vhodně nastavenými formátovacími kódy vytvoříte seznam všech vyhovujících souborů pro požadovaný příkaz. Tím se blíže zabývá kapitola 8.2.2 "Užitečné dávkové soubory, soubory SPAT a DPAT, využití příkazu LIST".
Příklady
| 1.Ram_Disk:> LIST Text 1 ----rwed Today 10:35:26 disk.info 824 ----rw-d Today 09:18:52 clipboards Dir ----rwed Today 09:18:52 t Dir ----rwed Today 16:57:12 env Dir ----rwed Today 13:37:35 2 files - 3 directories - 10 blocks used |
Takto zobrazí příkaz LIST obsah aktuálního adresáře.
| 1.System2.0:> LIST ram: LFORMAT="%-P %-30N %-L" ram: xx 3 ram: cc Dir ram: disk.info 824 ram: clipboards Dir ram: t Dir ram: env Dir |
Tento příkaz zobrazí obsah RAM-disku, výpis zobrazí cesty, jména a velikosti v bytech. Jména jsou zarovnána na 30 znaků, vše se vyrovnává na levý okraj.
