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.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_SIGNATURE\&.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_signature.conf \- Configuration file used by afpd(8) to specify server signature
  23 .SH "DESCRIPTION"
  24 .PP
  25 :ETCDIR:/afp_signature\&.conf
  26 is the configuration file used by
  27 \fBafpd\fR
  28 to specify server signature automagically\&. The configuration lines are composed like:
  29 .PP
  30 \fI"server name"\fR
  31 \fIhexa\-string\fR
  32 .PP
  33 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\&.
  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 Server Signature is unique 16\-bytes identifier used to prevent logging on to the same server twice\&.
  50 .PP
  51 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\&.
  52 .PP
  53 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\&.
  54 .PP
  55 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\&.
  56 .sp .5v
  57 .RE
  58 .PP
  59 .SH "EXAMPLES"
  60 .PP
  61 \fBExample.\ \&afp_signature.conf\fR
  62 .sp
  63 .if n \{\
  64 .RS 4
  65 .\}
  66 .nf
  67 # This is a comment\&.
  68 "My Server" 74A0BB94EC8C13988B2E75042347E528
  69 .fi
  70 .if n \{\
  71 .RE
  72 .\}
  73 .SH "SEE ALSO"
  74 .PP
  75 \fBafpd\fR(8),
  76 \fBafp.conf\fR(5),
  77 \fBasip-status.pl\fR(1)