man/man1/ad.1.in

   1 '\" t
   2 .\"     Title: ad
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
   5 .\"      Date: 02 Sep 2011
   6 .\"    Manual: @NETATALK_VERSION@
   7 .\"    Source: @NETATALK_VERSION@
   8 .\"  Language: English
   9 .\"
  10 .TH "AD" "1" "02 Sep 2011" "@NETATALK_VERSION@" "@NETATALK_VERSION@"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 ad \- Netatalk compatible UNIX file utility suite\&.
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBad\fR\ 'u
  34 \fBad\fR {ls\ |\ cp\ |\ mv\ |\ rm} [\&.\&.\&.]
  35 .HP \w'\fBad\fR\ 'u
  36 \fBad\fR {\-v\ |\ \-\-version}
  37 .SH "DESCRIPTION"
  38 .PP
  39 \fBad\fR
  40 is a UNIX file utility suite with Netatalk compatibility\&. AppleDouble
  41 files in
  42 \&.AppleDouble
  43 directories and the CNID databases are updated as appropriate\&.
  44 .SH "AVAILABLE COMMANDS"
  45 .HP \w'\fBad\ ls\fR\ 'u
  46 \fBad ls\fR [\-dRl\ [u]] {file|dir\ [\&.\&.\&.]}
  47 .PP
  48 List files and directories\&.
  49 .HP \w'\fBad\ cp\fR\ 'u
  50 \fBad cp\fR [\-aipvf] {src_file} {dst_file}
  51 .HP \w'\fBad\ cp\ \-R\fR\ 'u
  52 \fBad cp \-R\fR [\-aipvf] {src_file|src_directory\ \&.\&.\&.} {dst_directory}
  53 .PP
  54 Copy files and directories\&.
  55 .HP \w'\fBad\ mv\fR\ 'u
  56 \fBad mv\fR [\-finv] {src_file} {dst_file}
  57 .HP \w'\fBad\ mv\fR\ 'u
  58 \fBad mv\fR [\-finv] {src_file|src_directory\ \&.\&.\&.} {dst_directory}
  59 .PP
  60 Move files and directories\&.
  61 .HP \w'\fBad\ rm\fR\ 'u
  62 \fBad rm\fR [\-Rv] {file|directory}
  63 .HP \w'\fBad\ \-v|\-\-version\fR\ 'u
  64 \fBad \-v|\-\-version\fR
  65 .PP
  66 Show version\&.
  67 .SH "AD LS"
  68 .PP
  69 List files and directories\&. Options:
  70 .PP
  71 \-d
  72 .RS 4
  73 Directories are listed as plain files
  74 .RE
  75 .PP
  76 \-R
  77 .RS 4
  78 list subdirectories recursively
  79 .RE
  80 .PP
  81 \-l
  82 .RS 4
  83 Long output, list AFP info
  84 .RE
  85 .PP
  86 \-u
  87 .RS 4
  88 List UNIX info
  89 .RE
  90 .PP
  91 \fILong output description\fR
  92 .sp
  93 .if n \{\
  94 .RS 4
  95 .\}
  96 .nf
  97 <unixinfo> <FinderFlags> <AFP Attributes> <Color> <Type> <Creator> <CNID from AppleDouble> <name>
  98
  99 FinderFlags (valid for (f)iles and/or (d)irectories):
 100
 101   d = On Desktop                      (f/d)
 102   e = Hidden extension                (f/d)
 103   m = Shared (can run multiple times) (f)
 104   n = No INIT resources               (f)
 105   i = Inited                          (f/d)
 106   c = Custom icon                     (f/d)
 107   t = Stationery                      (f)
 108   s = Name locked                     (f/d)
 109   b = Bundle                          (f/d)
 110   v = Invisible                       (f/d)
 111   a = Alias file                      (f/d)
 112
 113 AFP Attributes:
 114
 115   y = System                          (f/d)
 116   w = No write                        (f)
 117   p = Needs backup                    (f/d)
 118   r = No rename                       (f/d)
 119   l = No delete                       (f/d)
 120   o = No copy                         (f)
 121
 122 Note: any letter appearing in uppercase means the flag is set but it\*(Aqs a directory for which the flag is not allowed\&.
 123 .fi
 124 .if n \{\
 125 .RE
 126 .\}
 127 .SH "AD CP"
 128 .PP
 129 Copy files and directories\&.
 130 .PP
 131 In the first synopsis form, the cp utility copies the contents of the source_file to the target_file\&. In the second synopsis form, the contents of each named source_file is copied to the destination target_directory\&. The names of the files themselves are not changed\&. If cp detects an attempt to copy a file to itself, the copy will fail\&.
 132 .PP
 133 Netatalk AFP volumes are detected by means of their "\&.AppleDesktop" directory which is located in their volume root\&. When a copy targeting an AFP volume is detected, its CNID database daemon is connected and all copies will also go through the CNID database\&. AppleDouble files are also copied and created as needed when the target is an AFP volume\&.
 134 .PP
 135 Options:
 136 .PP
 137 \-a
 138 .RS 4
 139 Archive mode\&. Same as \-Rp\&.
 140 .RE
 141 .PP
 142 \-f
 143 .RS 4
 144 For each existing destination pathname, remove it and create a new file, without prompting for confirmation regardless of its permis\- sions\&. (The \-f option overrides any previous \-i or \-n options\&.)
 145 .RE
 146 .PP
 147 \-i
 148 .RS 4
 149 Cause cp to write a prompt to the standard error output before copying a file that would overwrite an existing file\&. If the response from the standard input begins with the character \*(Aqy\*(Aq or \*(AqY\*(Aq, the file copy is attempted\&. (The \-i option overrides any pre\- vious \-f or \-n options\&.)
 150 .RE
 151 .PP
 152 \-n
 153 .RS 4
 154 Do not overwrite an existing file\&. (The \-n option overrides any previous \-f or \-i options\&.)
 155 .RE
 156 .PP
 157 \-p
 158 .RS 4
 159 Cause cp to preserve the following attributes of each source file in the copy: modification time, access time, file flags, file mode, user ID, and group ID, as allowed by permissions\&. If the user ID and group ID cannot be preserved, no error message is displayed and the exit value is not altered\&.
 160 .RE
 161 .PP
 162 \-R
 163 .RS 4
 164 If source_file designates a directory, cp copies the directory and the entire subtree connected at that point\&.If the source_file ends in a /, the contents of the directory are copied rather than the directory itself\&.
 165 .RE
 166 .PP
 167 \-v
 168 .RS 4
 169 Cause cp to be verbose, showing files as they are copied\&.
 170 .RE
 171 .PP
 172 \-x
 173 .RS 4
 174 File system mount points are not traversed\&.
 175 .RE
 176 .SH "AD MV"
 177 .PP
 178 Move files and directories\&.
 179 .PP
 180 Move files around within an AFP volume, updating the CNID database as needed\&. If either:
 181 .sp
 182 .RS 4
 183 .ie n \{\
 184 \h'-04'\(bu\h'+03'\c
 185 .\}
 186 .el \{\
 187 .sp -1
 188 .IP \(bu 2.3
 189 .\}
 190 source or destination is not an AFP volume
 191 .RE
 192 .sp
 193 .RS 4
 194 .ie n \{\
 195 \h'-04'\(bu\h'+03'\c
 196 .\}
 197 .el \{\
 198 .sp -1
 199 .IP \(bu 2.3
 200 .\}
 201 source AFP volume != destination AFP volume
 202 .RE
 203 .sp
 204 the files are copied and removed from the source\&.
 205 .PP
 206 Options:
 207 .PP
 208 \-f
 209 .RS 4
 210 Do not prompt for confirmation before overwriting the destination path\&. (The \-f option overrides any previous \-i or \-n options\&.)
 211 .RE
 212 .PP
 213 \-i
 214 .RS 4
 215 Cause mv to write a prompt to standard error before moving a file that would overwrite an existing file\&. If the response from the standard input begins with the character `y\*(Aq or `Y\*(Aq, the move is attempted\&. (The \-i option overrides any previous \-f or \-n options\&.)
 216 .RE
 217 .PP
 218 \-n
 219 .RS 4
 220 Do not overwrite an existing file\&. (The \-n option overrides any previous \-f or \-i options\&.)
 221 .RE
 222 .PP
 223 \-v
 224 .RS 4
 225 Cause mv to be verbose, showing files after they are moved\&.
 226 .RE
 227 .SH "AD RM"
 228 .PP
 229 Remove files and directories\&.
 230 .PP
 231 The rm utility attempts to remove the non\-directory type files specified on the command line\&. If the files and directories reside on an AFP volume, the corresponding CNIDs are deleted from the volumes database\&.
 232 .PP
 233 The options are as follows:
 234 .PP
 235 \-R
 236 .RS 4
 237 Attempt to remove the file hierarchy rooted in each file argument\&.
 238 .RE
 239 .PP
 240 \-v
 241 .RS 4
 242 Be verbose when deleting files, showing them as they are removed\&.
 243 .RE
 244 .SH "REPORTING BUGS"
 245 .PP
 246 Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
 247 .SH "SEE ALSO"
 248 .PP
 249 \fBdbd\fR(1),
 250 \fBapple_dump\fR(1)\&.