CPMCHATTR(1)

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

💅 CPMCHATTR(1) — the user-commands girlies' fave 💅

okay so bestie, welcome to the cpmchattr page, manual section 1 (user commands, obvs) 🎀 this is the lil tool that changes file attributes on CP/M files. no cap.

✨ NAME ✨

cpmchattr — change file attributes on CP/M files 🦋

✨ SYNOPSIS ✨

cpmchattr [-f format] [-u] image attrib file-pattern ...

✨ DESCRIPTION ✨

Cpmchattr changes the file attributes for files on CP/M disks. that's it, that's the whole vibe. you point it at a disk image, you tell it which attributes you want, you say which files, and it goes off and does the thing 💖

✨ OPTIONS ✨

  • -f format — use the given CP/M disk format instead of the default format. main character energy: you pick, not the default.
  • -T libdsk-type — libdsk driver type, like tele for Teledisk images or raw for raw images. ⚠️ requires building cpmtools with support for libdsk, so if it's not there it's just not there, sorry bestie 🫶
  • -u — show all CP/M file names in UPPER CASE. like she's yelling, but politely 💅
  • attrib — set the file attributes as given. this is the actual instruction, the moment, the point.

✨ FILE ATTRIBUTES ✨

the file attribute string can contain the characters 1, 2, 3, 4, r, s, a, n and m. here's what each one means, no gatekeeping 🔥

  • 1–4 — the CP/M "user attributes" F1–F4. CP/M does not assign any meaning to these attributes, though MP/M does. so like, CP/M is chill about them, MP/M is the one with opinions 😭
  • r — the file is read-only. this is the same as using cpmchmod(1) to revoke write permissions.
  • s — the file is a system file. this attribute can also be set by cpmchmod(1).
  • a — the file has been backed up. ✨
  • n — reset all attributes to zero. so the string "n1r" resets all attributes and then sets F1 and Read-Only. iconic combo honestly.
  • m — attributes after an m are unset rather than set. the string "12m34" sets atttributes F1 and F2, and unsets F3 and F4.
note the vibe: everything before the m is getting turned ON, everything after it is getting turned OFF. it's giving switch 🧚

✨ RETURN VALUE ✨

upon successful completion, exit code 0 is returned. slay. ✨

✨ ERRORS ✨

any errors are indicated by exit code 1. 💀

✨ ENVIRONMENT ✨

  • CPMTOOLSFMT — default format 🌸

✨ FILES ✨

  • /etc/cpmtools/diskdefs — CP/M disk format definitions 🎀

✨ AUTHORS ✨

this program is copyright 1997–2021 Michael Haardt <michael@moria.de> and copyright 2000, 2001, 2011 John Elliott <jce@seasip.demon.co.uk>. absolute legends, fr fr 👑

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. 💌

✨ SEE ALSO ✨

and that's the whole page bestie, mwah 💖 this one came from the CP/M tools collection, dated November 2, 2022, and it lives at the top of its own little manual page as CPMCHATTR(1) 🎀 go forth and change those attributes, you've got this 👑✨

📦 where this page comes from