CPCFS(1)

💾 CPCFS(1) — okay so this is the manual, bestie 💾

The raw header says TEMPLATE() on both sides, and the manual name is CPCFS(1), so we’re folding that in right here 💅. No cap, we’re keeping every token, every placeholder, every weird little detail. Periodt.

🎀 NAME 🎀

template — that’s the NAME line, fr fr. Then the page launches straight into command-token energy:

• ~open~ — Closes the one in memory, if any. It appends the string .DSK to the DOS filename, if no extension is given.
• ~close~ — raw token, exactly as written; no extra deets on this page.
• ~user~~get~ — raw token combo, exactly ~user~~get~ with no space between them.
• ~mget~ — raw token, exactly as written.
• ~put~ — raw token, exactly as written.
• ~mput~ — raw token, exactly as written.
• ~mode~ — Printable characters are newlines (10,13) and characters between space (32) and tilde (126). mode can be abbreviated to its first character B, T, or A.
• ~sysgen~ — It only works, if the image was formatted with two system tracks (e.g. system or vortex format). See STAT, if you want to know the format or whether CP/M is already in the image.

To obtain a CP/M-image you can use the accompanying BASIC program GETCPM.BAS. It runs on a CPC and copies the system tracks off a real CPC disk to the file SYSTEM.CPM. Then transfer the file to DOS.

If you want to "sysgen" your vortex image, you must prepare CP/M first (see your vortex documentation).

WARNING: I do not own a vortex drive nor its documentation, so I cannot tell if it works. Feedback is highly appreciated!!!~!~

• ~!~ — Executes the program command in a DOS-Shell. If only a "!" is typed, CPCFS invokes the interactive shell given in the %COMSPEC% environment variable or C:\COMMAND.COM if the variable isn't set. You must type EXIT to return from the shell to CPCFS. Contrary to other commands there is no space needed behind the "!".
• ~cd~ — raw token, exactly as written.

The "L" in LCD (as well as in LDIR) reminds you, that this command affects the local filesystem of DOS.

• ~ldir~ — raw token, exactly as written.

🌈 Informational 🌈

• ~dir~ — raw token, exactly as written.
• ~stat~ — raw token, exactly as written.
• ~dpb~ and ~background~ — raw tokens, exactly as written.
• ~comment~ — raw token, exactly as written.
• ~type~ — raw token, exactly as written.
• ~dump~ — raw token, exactly as written.

Note: Options for DUMP can be packed, but this can be confusing E.g. DUMP -B0 -2B5 for blocks 0 to 5 or DUMP -12 for blocks form beginning (1) to the same block (1).

🌸 Changing files 🌸

• ~format~ — raw token, exactly as written.
• ~del~ — raw token, exactly as written.
• ~ren~ — REN uses the well-known DOS order for renaming (think of the word TO between the filenames) and not the (possibly expected) CP/M order (think of := between the filenames).
• ~attrib~ — raw token, exactly as written.
• ~copy~ — raw token, exactly as written.

This is a comment. Everything upto the next command is ignored.

• ~quit~ — Quits CPCFS. You can hit Ctrl+Z to achieve the same purpose, only faster! (The Unix version uses Ctrl+D as shortcut for Quit)
• ~help~ — The startup helppage is:

---------------------------------------------------- ~nothing~
----------------------------------------------------

• ~source~ — raw token, exactly as written.
• ~echo~ — raw token, exactly as written.
• ~prompt~ — raw token, exactly as written.
• ~cls~ — raw token, exactly as written.
• ~force~ — raw token, exactly as written.
• ~verbosity~ — raw token, exactly as written.
• ~page~ — CPCFS has an internal pager for commands like DUMP, TYPE, and so on. With the PAGE command you can set the number of lines of your screen (the default is 25). If you set PAGE 0, you bypass the internal pager and things are displayed without stops.

🐚 FILENAMES 🐚

~filenames~ — raw token, exactly as written.

✏️ EDITING ✏️

~editing~ — raw token, exactly as written.

🔢 VALUES & PERCENT EXPANSION 🔢

~values~ and ~percent~ — both raw tokens, exactly as written.

📁 FILES 📁

• CPCFS.CFG — The commands in this file are executed every time CPCFS starts in interactive mode. You can set the PROMPT here or open an often used image or ...
  • CPCFS looks for it at first in the current directory and then in the directory where CPCFS.EXE resides.
  • If the environment variable CPCFSHOME is set, then CPCFS looks here.
• *.DSK — This is the default extension for imagfiles
• *.CPM — This is the default extension for CP/M tracks saved by GETCPM.BAS and needed by SYSGEN.

👀 SEE ALSO 👀

GETCPM.BAS, a Locomotive BASIC program to copy CP/M tracks off a diskette and save them to a file. Simply type it in your original CPC (you can leave out REMarks and PRINTs) and run it on a CP/M system disk. It creates a file, that you have to transfer in some way to DOS (read the CPCEmu documentation for various ways, how to arrange it). Finally use CPCFS' SYSGEN command to create a diskimage with CP/M.

DROPTAG.BAT, a batch file replacing DROPTAG.EXE of the former distribution.

🌟 RELATED WORKS 🌟

• CPCEmu (C) Marco Vieth (ali@uni-paderborn.de) — Current version: 1.3b Available on: ftp://oak.oakland.edu/Simtel/msdos/emulator or any other Simtel site
• CPE (C) Bernd Schmidt (crux@pool.informatik.rwth-aachen.de) — Current Version: 5.0 Available on: ftp://oak.oakland.edu/Simtel/msdos/emulator or any other Simtel site
• comp.sys.amstrad.8bit — A usenet newsgroup for discussing CPC related topics
• http://arachnid.cm.cf.ac.uk/User/K.E.W.Thacker/Amstrad — A WWW page with a lot of CPC stuff.
• ftp://ftp.ibp.fr/pub/amstrad/amstrad.faq
• ftp://rtfm.mit.edu/pub/usenet/comp.sys.amstrad.8bit — The Amstrad FAQ

🐛 BUGS 🐛

~bugs~ — raw token, exactly as written.

⚖️ LEGAL STUFF ⚖️

~about~ — raw token, exactly as written.

Trademarks: "CPC", "Amsdos" is from Amstrad "CP/M" is from Digital Research (now Novell) "Borland C" is from Borland "ACTlib 1.7" is public domain and written by Marc Stern

👑 AUTHOR 👑

Derik van Zuetphen

email: dz@426.ch www: http://www.426.ch

The latest version of CPCFS and recent patches can be found in my Github repository on https://github.com/derikz/cpcfs

---

okay that’s the whole page, signed off with TEMPLATE() and dated January 1980 — bye bestie, slay 💖✨