Jak jsem psal včera - vydal jsem Calm Commander 1.0 a jedna z jeho novinek byla i kopírování adresářů a podadresářů a to do hloubky 11 podaddresářů. Uveřejnil jsem tuto novinku na FB stránce ZX Spectrum Next s tím, že si chvilku odpočinu, ale rozhořela se tam diskuze o tom, proč není Calm Commander dot command. Je to jednoduché - protože já ho jako dot command nikdy nechtěl - popravdě si myslím, že by to bylo kontraproduktivní. Calm Commander zabírá spousttu místa - LFN i 8.3 jména souborů/adresářůnačteného adresáře si drží v paměti, při kopírování si ukládá data do co největší části paměti, pluginy sami o sobě také něco sežraly (myslím tím paměť). Ale nějak se tam ve mne zrodila myšlinka udělat několik dot příkazů - kopírování, delete a dirinfo. A dnes bych Vám rád představil příkaz copy.

Syntaxe
.copy zdroj cil
.copy -s zdroj -d cil

Oba formáty jsou rovnocenné. Cesty s mezerami v názvu uzavřete do uvozovek.

Přepínače
  • -m — move (přesun): po úspěšném zkopírování smaže zdrojový soubor nebo adresář
  • -y — yes (přepis): přepisuje existující cílové soubory; bez tohoto přepínače se existující soubory přeskočí
  • -h — zobrazí nápovědu

Kopírování jednoho souboru:
Soubor se čte do 8 kB pracovního bufferu na adrese $DC00 a zapisuje se na cíl po blocích. Pokud cíl končí lomítkem nebo jde o existující adresář, jméno zdrojového souboru se přidá automaticky. Jinak se cílová cesta použije jako výsledné jméno souboru.

Kopírování adresáře (rekurzivní):

  1. Příkaz prochází adresářový strom do hloubky 11 úrovní (MAX_DEPTH = 11).
  2. Každý podadresář vytvoří v cíli (F_MKDIR – chyba „již existuje" se ignoruje).
  3. Soubory v každém podadresáři zkopíruje se zachováním dlouhých jmen (LFN).
  4. Před vlastní kopií projde strom naprázdno a spočítá položky – kvůli zobrazení průběhu.
  5. Průběh se zobrazuje jako Copying: nazev_adresare (X/celkem) a pro každý soubor soubor [XkB/CelkemkB].
  6. Adresářové handles se před rekurzí uzavírají a po ní znovu otevírají – tím se obchází omezení NextZXOS na počet současně otevřených handles.

Přesun adresáře (-m):
Nejprve proběhne kompletní rekurzivní kopie, pak se celý zdrojový strom smaže (soubory přes F_UNLINK, adresáře přes F_RMDIR zdola nahoru). Pro přesun jednoho souboru se nejdříve zkusí F_RENAME (rychlé přejmenování na stejném disku); teprve pokud selže, provede se kopie + smazání.

Chování při přepisu
  • Bez -y: existující cílový soubor se přeskočí a zobrazí se Skipping existing: jmeno.
  • S -y: cílový soubor se přepíše.
Pravidla pro cílovou cestu
  • Cíl končí / nebo \ → zdrojové jméno se přidá za lomítko.
  • Cíl je existující adresář → zdrojové jméno se zkopíruje do tohoto adresáře.
  • Jinak → cíl je výsledné jméno souboru nebo adresáře.
  • Zdrojová cesta s koncovým lomítkem (adresar/) se normalizuje na adresar.
Bezpečnostní pojistky
  • Ochrana před kopírováním adresáře do sebe: příkaz zjistí, zda cílová cesta není podadresářem zdrojové, a kopii odmítne.
  • Ověření cílového rodiče: před zahájením kopie zkontroluje, že nadřazený adresář cíle existuje. Pokud ne, skončí s hláškou copy: destiny path not found.
  • Přerušení stiskem BREAK (CAPS SHIFT + SPACE): zastaví operaci kdykoli, smaže rozepsaný cílový soubor a vypíše Cancelled.
  • Příkaz instaluje ROM error handler, aby chyby (typicky chybějící jednotka na emulátorech) nespadly do BASICu.
Výkon

Během kopírování a mazání se CPU dočasně přepne na 28 MHz (NextReg $07 = 3). Po skončení – ať úspěšném, chybném, nebo zrušeném – se turbo vrátí na původní hodnotu.

Pár technických věcí
  • Pracovní buffer: 8192 bajtů na adrese $DC00–$FBFF
  • Zásobník zdrojových cest: $C000 (12 × 256 bajtů)
  • Zásobník cílových cest: $CC00 (12 × 256 bajtů)
  • Maximální délka cesty: 255 znaků
  • Maximální hloubka podadresářů: 11 úrovní
  • Adresáře se čtou v LFN režimu → dlouhá jména jsou zachována
  • Spouští se na adrese $2000 (standardní dot command)
Příklady
.copy zaloha zaloha2

Zkopíruje soubor nebo adresář zaloha do zaloha2.

.copy -y "Calm Commander" "backup/"

Zkopíruje adresář Calm Commander (s mezerou v názvu) do backup/Calm Commander. Existující soubory přepíše.

.copy -s "muj adresar" -d "d:/moje zaloha"

Kopírování s cestami v uvozovkách je vhodné, když cesta obsahuje mezery.

.copy -m stary novy

Přesune adresář stary na novy (kopie + smazání zdroje).

Chybové hlášky a výstup z .copy
  • copy: missing or bad arguments — chybí zdroj nebo cíl, nebo neznámý přepínač
  • copy: destiny path not found — nadřazený adresář cíle neexistuje
  • copy: esxDOS error $XX stg $YY — interní chyba; XX je esxDOS chybový kód, YY je fáze (pro ladění)
  • Skipping existing: jmeno — soubor na cíli existuje a nebyl zadán -y
  • Cancelled. — uživatel stiskl BREAK
  • Done. — kopírování nebo přesun úspěšně dokončen

Ke stažení: shrek128.itch.io