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)