man/man1/ad.1

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