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.78.0 <http://docbook.sf.net/>
   5 .\"      Date: 23 Mar 2012
   6 .\"    Manual: Netatalk 3.0
   7 .\"    Source: Netatalk 3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AFP_VOLUUID\&.CONF" "5" "23 Mar 2012" "Netatalk 3.0" "Netatalk 3.0"
  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 afp_voluuid.conf \- Configuration file used by afpd(8) to specify UUID for Time Machine volume
  32 .SH "DESCRIPTION"
  33 .PP
  34 :STATEDIR:/netatalk/afp_voluuid\&.conf
  35 is the configuration file used by
  36 \fBafpd\fR
  37 to specify UUID of Time Machine volume automagically\&. The configuration lines are composed like:
  38 .PP
  39 \fI"volume name"\fR
  40 \fIuuid\-string\fR
  41 .PP
  42 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\&.
  43 .PP
  44 The leading spaces and tabs are ignored\&. Blank lines are ignored\&. The lines prefixed with # are ignored\&. The illegal lines are ignored\&.
  45 .if n \{\
  46 .sp
  47 .\}
  48 .RS 4
  49 .it 1 an-trap
  50 .nr an-no-space-flag 1
  51 .nr an-break-flag 1
  52 .br
  53 .ps +1
  54 \fBNote\fR
  55 .ps -1
  56 .br
  57 .PP
  58 This UUID is advertised by Zeroconf in order to provide robust disambiguation of Time Machine volume\&.
  59 .PP
  60 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\&.
  61 .PP
  62 This file should not be thoughtlessly edited and be copied onto another server\&.
  63 .sp .5v
  64 .RE
  65 .PP
  66 .SH "EXAMPLES"
  67 .PP
  68 \fBExample.\ \&afp_voluuid.conf three TM volumes on one netatalk\fR
  69 .sp
  70 .if n \{\
  71 .RS 4
  72 .\}
  73 .nf
  74 # This is a comment\&.
  75 "Backup for John Smith" 1573974F\-0ABD\-69CC\-C40A\-8519B681A0E1
  76 "bob" 39A487F4\-55AA\-8240\-E584\-69AA01800FE9
  77 mary 6331E2D1\-446C\-B68C\-3066\-D685AADBE911
  78 .fi
  79 .if n \{\
  80 .RE
  81 .\}
  82 .SH "SEE ALSO"
  83 .PP
  84 \fBafpd\fR(8),
  85 \fBafp.conf\fR(5),
  86 \fBavahi-daemon\fR(8),
  87 \fBmDNSResponder\fR(8)