CPMCP(1)

📦
version 2.23 · 3 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 CPMCP(1) — like, the copy-files-between-here-and-a-CP/M-disk manual 💖

okay bestie, welcome to the CP/M tools girlies' club 🎀 this is the manual page for cpmcp, a user command, and I'm gonna walk you through it like we're texting at 1am. no cap, every flag is here. periodt.

✨ NAME ✨

cpmcp — copy files from and to CP/M disks 🦋

like, it's a two-way street. files go in, files come out, the disk stays iconic.

🌸 SYNOPSIS 🌸

cpmcp [-f format] [-p] [-t] image [-u] user:file ... directory
cpmcp [-f format] [-p] [-t] image [-u] file user:file
cpmcp [-f format] [-p] [-t] image [-u] file ... user:

four whole shapes of the same vibe, pick whichever one matches what you're doing 💅

💫 DESCRIPTION 💫

so cpmcp copies one or more files to or from a CP/M disk. that's the whole main character moment.

when you're copying multiple files, the last argument has to be a drive or a directory. no exceptions, bestie.

the drive letter does not matter because the device is specified by the image — the letter is literally just there to tell cpmcp which direction you wanna copy. that's it. that's its whole job. 🙈

the user number comes after the drive letter, and if you just… don't include it, user 0 is used. default behaviour, we love her.

you can use * and ? in CP/M file names, and they mean the same thing they mean in sh(1) file name patterns. so if you already know your globbing, you're set 🧚

okay now the spicy part. on CP/M, the slash is a legal file name character. 😭 so when you copy those files over to the host, it gets translated to a comma. and filenames that have a comma get translated back to a slash on CP/M. it's giving translation era. and it's no restriction at all, because a comma is not a legal CP/M filename character. so nobody's ever gonna collide. slay.

👑 OPTIONS 👑

  • -f format — use the given CP/M disk format instead of the default format. you're overriding destiny ✨
  • -T libdsk-type — libdsk driver type, like tele for Teledisk images or raw for raw images. heads up: this one requires building cpmtools with support for libdsk, so if you didn't, it's not gonna happen for you 💀
  • -p — preserve time stamps when copying files from CP/M to UNIX. not implemented for copying the other way so far, so it's a one-directional queen 🫶
  • -t — convert text files between CP/M and UNIX conventions. line endings deserve love too 🌈
  • -u — show all CP/M file names in upper case. LOUD AND PROUD 📣

💜 RETURN VALUE 💜

upon successful completion, exit code 0 is returned. that's the good ending. we ate. 🔥

💀 ERRORS 💀

any errors are indicated by exit code 1. it's giving "not me getting an error" but hey, at least it's honest.

🌱 ENVIRONMENT 🌱

  • CPMTOOLSFMT — default format. she's the fallback when you don't pass -f 💖

🍓 FILES 🍓

  • /etc/cpmtools/diskdefs — CP/M disk format definitions. this is where all the disk lore lives.

🎀 AUTHORS 🎀

this program is copyright 1997–2021 Michael Haardt <michael@moria.de>. 💖

the Windows port is copyright 2000, 2001, 2011 John Elliott <jce@seasip.demon.co.uk>.

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

you should have received a copy of the GNU General Public License along with this program. if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

(so basically: it's free, it's open, and it comes with absolutely zero promises. read the license, bestie, it's not long and it's kinda iconic.)

🦋 SEE ALSO 🦋

okay that's the whole page!! go copy some files, you're gonna do amazing 💅✨

signing off with love from the CP/M tools girlies, version of November 2, 2022 🩷 byeeee 🎀

📦 where this page comes from