man/man5/afp_voluuid.conf.5.tmpl

   1 '\" t
   2 .\"     Title: afp_voluuid.conf
   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: 22 Mar 2012
   6 .\"    Manual: Netatalk 3.0
   7 .\"    Source: Netatalk 3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AFP_VOLUUID\&.CONF" "5" "22 Mar 2012" "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 afp_voluuid.conf \- Configuration file used by afpd(8) to specify UUID for Time Machine volume
  23 .SH "DESCRIPTION"
  24 .PP
  25 :ETCDIR:/afp_voluuid\&.conf
  26 is the configuration file used by
  27 \fBafpd\fR
  28 to specify UUID of Time Machine volume automagically\&. The configuration lines are composed like:
  29 .PP
  30 \fI"volume name"\fR
  31 \fIuuid\-string\fR
  32 .PP
  33 The first field is volume name\&. Volume names must be quoted if they contain spaces\&. The second field is the 36 character hexadecimal ASCII string representation of a UUID\&.
  34 .PP
  35 The leading spaces and tabs are ignored\&. Blank lines are ignored\&. The lines prefixed with # are ignored\&. The illegal lines are ignored\&.
  36 .if n \{\
  37 .sp
  38 .\}
  39 .RS 4
  40 .it 1 an-trap
  41 .nr an-no-space-flag 1
  42 .nr an-break-flag 1
  43 .br
  44 .ps +1
  45 \fBNote\fR
  46 .ps -1
  47 .br
  48 .PP
  49 This UUID is advertised by Zeroconf in order to provide robust disambiguation of Time Machine volume\&.
  50 .PP
  51 The afpd generates the UUID from random numbers and saves it into afp_voluuid\&.conf, only when setting "time machine = yes" option in afp\&.conf\&.
  52 .PP
  53 This file should not be thoughtlessly edited and be copied onto another server\&.
  54 .sp .5v
  55 .RE
  56 .PP
  57 .SH "EXAMPLES"
  58 .PP
  59 \fBExample.\ \&afp_voluuid.conf three TM volumes on one netatalk\fR
  60 .sp
  61 .if n \{\
  62 .RS 4
  63 .\}
  64 .nf
  65 # This is a comment\&.
  66 "Backup for John Smith" 1573974F\-0ABD\-69CC\-C40A\-8519B681A0E1
  67 "bob" 39A487F4\-55AA\-8240\-E584\-69AA01800FE9
  68 mary 6331E2D1\-446C\-B68C\-3066\-D685AADBE911
  69 .fi
  70 .if n \{\
  71 .RE
  72 .\}
  73 .SH "SEE ALSO"
  74 .PP
  75 \fBafpd\fR(8),
  76 \fBafp.conf\fR(5),
  77 \fBavahi-daemon\fR(8),
  78 \fBmDNSResponder\fR(8)