man/man5/afp_signature.conf.5.tmpl

   1 '\" t
   2 .\"     Title: afp_signature.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_SIGNATURE\&.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_signature.conf \- Configuration file used by afpd(8) to specify server signature
  32 .SH "DESCRIPTION"
  33 .PP
  34 :STATEDIR:/netatalk/afp_signature\&.conf
  35 is the configuration file used by
  36 \fBafpd\fR
  37 to specify server signature automagically\&. The configuration lines are composed like:
  38 .PP
  39 \fI"server name"\fR
  40 \fIhexa\-string\fR
  41 .PP
  42 The first field is server name\&. Server names must be quoted if they contain spaces\&. The second field is the hexadecimal string of 32 characters for 16\-bytes server signature\&.
  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 Server Signature is unique 16\-bytes identifier used to prevent logging on to the same server twice\&.
  59 .PP
  60 Netatalk 2\&.0 and earlier generated server signature by using gethostid()\&. There was a problem that another servers have the same signature because the hostid is not unique enough\&.
  61 .PP
  62 Current netatalk generates the signature from random numbers and saves it into afp_signature\&.conf\&. When starting next time, it is read from this file\&.
  63 .PP
  64 This file should not be thoughtlessly edited and be copied onto another server\&. If it wants to set the signature intentionally, use the option "signature =" in afp\&.conf\&. In this case, afp_signature\&.conf is not used\&.
  65 .sp .5v
  66 .RE
  67 .PP
  68 .SH "EXAMPLES"
  69 .PP
  70 \fBExample.\ \&afp_signature.conf\fR
  71 .sp
  72 .if n \{\
  73 .RS 4
  74 .\}
  75 .nf
  76 # This is a comment\&.
  77 "My Server" 74A0BB94EC8C13988B2E75042347E528
  78 .fi
  79 .if n \{\
  80 .RE
  81 .\}
  82 .SH "SEE ALSO"
  83 .PP
  84 \fBafpd\fR(8),
  85 \fBafp.conf\fR(5),
  86 \fBasip-status.pl\fR(1)