git.gag.com Git - debian/cpmtools/blob - cpmchattr.1.in

   1 .TH CPMCHATTR 1 "@UPDATED@" "CP/M tools" "User commands"
   2 .SH NAME \"{{{roff}}}\"{{{
   3 cpmchattr \- change file attributes on CP/M files
   4 .\"}}}
   5 .SH SYNOPSIS \"{{{
   6 .ad l
   7 .B cpmchattr
   8 .RB [ \-f
   9 .IR format ]
  10 .I image
  11 .I attrib
  12 .I file-pattern
  13 \&...
  14 .ad b
  15 .\"}}}
  16 .SH DESCRIPTION \"{{{
  17 \fBCpmchattr\fP changes the file attributes for files on CP/M disks.
  18 .\"}}}
  19 .SH OPTIONS \"{{{
  20 .IP "\fB\-f\fP \fIformat\fP"
  21 Use the given CP/M disk \fIformat\fP instead of the default format.
  22 .IP "\fIattrib\fP"
  23 Set the file attributes as given.
  24 .\"}}}
  25 .SH "FILE ATTRIBUTES" \"{{{
  26 The file attribute string can contain the characters
  27 1,2,3,4,r,s,a,n and m.
  28 The meanings of these are:
  29 .TP
  30 .B 1-4
  31 The CP/M "user attributes" F1-F4.  CP/M does not assign any
  32 meaning to these attributes, though MP/M does.
  33 .TP
  34 .B r
  35 The file is read-only.  This is the same as using
  36 .I cpmchmod(1)
  37 to revoke write permissions.
  38 .TP
  39 .B s
  40 The file is a system file.  This attribute can also be set by
  41 .I cpmchmod(1).
  42 .TP
  43 .B a
  44 The file has been backed up.
  45 .TP
  46 .B n
  47 Reset all attributes to zero.  So the string "n1r" resets all attributes and
  48 then sets F1 and Read-Only.
  49 .TP
  50 .B m
  51 Attributes after an m are unset rather than set.  The string "12m34" sets
  52 atttributes F1 and F2, and unsets F3 and F4.
  53 .\"}}}
  54 .SH "RETURN VALUE" \"{{{
  55 Upon successful completion, exit code 0 is returned.
  56 .\"}}}
  57 .SH ERRORS \"{{{
  58 Any errors are indicated by exit code 1.
  59 .\"}}}
  60 .SH ENVIRONMENT \"{{{
  61 CPMTOOLSFMT     Default format
  62 .\"}}}
  63 .SH FILES \"{{{
  64 @DATADIR@/diskdefs      CP/M disk format definitions
  65 .\"}}}
  66 .SH AUTHORS \"{{{
  67 This program is copyright 1997\(en2012 Michael Haardt
  68 <michael@moria.de> and copyright 2000, 2001, 2011 John Elliott
  69 <jce@seasip.demon.co.uk>.
  70 .PP
  71 This program is free software; you can redistribute it and/or modify
  72 it under the terms of the GNU General Public License as published by
  73 the Free Software Foundation; either version 3 of the License, or
  74 (at your option) any later version.
  75 .PP
  76 This program is distributed in the hope that it will be useful,
  77 but WITHOUT ANY WARRANTY; without even the implied warranty of
  78 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  79 GNU General Public License for more details.
  80 .PP
  81 You should have received a copy of the GNU General Public License along
  82 with this program.  If not, write to the Free Software Foundation, Inc.,
  83 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  84 .\"}}}
  85 .SH "SEE ALSO" \"{{{
  86 .IR cpmls (1),
  87 .IR cpmchmod (1),
  88 .IR cpm (5)
  89 .\"}}}