---
name: "cpmchattr"
section: "1"
platform: "linux"
package: "cpmtools"
version: "2.23-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cpmchattr"
---

# cpmchattr(1)

change file attributes on CP/M files

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

## OPTIONS

- **-f** *format*

  Use the given CP/M disk *format* instead of the default format.

- **-T** *libdsk-type*

  libdsk driver type, e.g. **tele** for Teledisk images or **raw** for raw images  (requires building cpmtools with support for libdsk).

- **-u**

  Show all CP/M file names in upper case.

- *attrib*

  Set the file attributes as given.

## FILE ATTRIBUTES

The file attribute string can contain the characters 1,2,3,4,r,s,a,n and m. The meanings of these are:

- **1-4**

  The CP/M "user attributes" F1-F4.  CP/M does not assign any meaning to these attributes, though MP/M does.

- **r**

  The file is read-only.  This is the same as using *[cpmchmod(1)](/cpmchmod/1.md)* to revoke write permissions.

- **s**

  The file is a system file.  This attribute can also be set by *[cpmchmod(1)](/cpmchmod/1.md).*

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

- **m**

  Attributes after an m are unset rather than set.  The string "12m34" sets atttributes F1 and F2, and unsets F3 and F4.

## RETURN VALUE

Upon successful completion, exit code 0 is returned.

## 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\>.

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

[*cpmls*(1)](/cpmls/1.md), [*cpmchmod*(1)](/cpmchmod/1.md), [*cpm*(5)](/cpm/5.md)