CPMCHATTR(1)

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

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
${prefix}/share/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), cpmchmod(1), cpm(5)