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