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

       /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), cpmchmod(1), cpm(5)

CP/M tools                                      November 2, 2022                                    CPMCHATTR(1)