From c6a46a1199600ad4ce6095a8a4d33a0b94f7e82a Mon Sep 17 00:00:00 2001 From: Frank Lahm Date: Tue, 14 Feb 2012 12:59:09 +0100 Subject: [PATCH] Remove old manpages and config files --- config/AppleVolumes.default.tmpl | 186 ------- config/AppleVolumes.system | 326 ------------ config/Makefile.am | 94 +--- config/afp.conf | 19 + config/afpd.conf.tmpl | 362 ------------- config/netatalk.conf | 61 --- man/man5/AppleVolumes.5 | 1 - man/man5/AppleVolumes.default.5.tmpl | 732 --------------------------- man/man5/AppleVolumes.system.5 | 1 - man/man5/Makefile.am | 18 +- man/man5/afp_ldap.conf.5.tmpl | 164 ------ man/man5/afp_signature.conf.5.tmpl | 79 --- man/man5/afp_voluuid.conf.5.tmpl | 77 --- man/man5/afpd.conf.5.tmpl | 676 ------------------------- man/man5/netatalk.conf.5.tmpl | 122 ----- 15 files changed, 26 insertions(+), 2892 deletions(-) delete mode 100644 config/AppleVolumes.default.tmpl delete mode 100644 config/AppleVolumes.system create mode 100644 config/afp.conf delete mode 100644 config/afpd.conf.tmpl delete mode 100644 config/netatalk.conf delete mode 100644 man/man5/AppleVolumes.5 delete mode 100644 man/man5/AppleVolumes.default.5.tmpl delete mode 100644 man/man5/AppleVolumes.system.5 delete mode 100644 man/man5/afp_ldap.conf.5.tmpl delete mode 100644 man/man5/afp_signature.conf.5.tmpl delete mode 100644 man/man5/afp_voluuid.conf.5.tmpl delete mode 100644 man/man5/afpd.conf.5.tmpl delete mode 100644 man/man5/netatalk.conf.5.tmpl diff --git a/config/AppleVolumes.default.tmpl b/config/AppleVolumes.default.tmpl deleted file mode 100644 index eeb20a85..00000000 --- a/config/AppleVolumes.default.tmpl +++ /dev/null @@ -1,186 +0,0 @@ -# This file looks empty when viewed with "vi". In fact, there is one -# '~', so users with no AppleVolumes file in their home directory get -# their home directory by default. - -# -# volume format: -# :DEFAULT: [all of the default options except volume name] -# path [name] [casefold:x] [options:z,l,j] \ -# [allow:a,@b,c,d] [deny:a,@b,c,d] [dbpath:path] [password:p] \ -# [rwlist:a,@b,c,d] [rolist:a,@b,c,d] [limitsize:value in bytes] \ -# [preexec:cmd] [root_preexec:cmd] [postexec:cmd] [root_postexec:cmd] \ -# [allowed_hosts:IPv4 address[/IPv4 netmask bits]] \ -# [denied_hosts:IPv4 address[/IPv4 netmask bits]] \ -# ... more, see below ... -# -# name: volume name. it can't include the ':' character -# - -# -# variable substitutions: -# you can use variables for both and now. here are the -# rules: -# 1) if you specify an unknown variable, it will not get converted. -# 2) if you specify a known variable, but that variable doesn't have -# a value, it will get ignored. -# -# the variables: -# $b -> basename of path -# $c -> client's ip or appletalk address -# $d -> volume pathname on server -# $f -> full name (whatever's in the gecos field) -# $g -> group -# $h -> hostname -# $i -> client ip without tcp port or appletalk network -# $s -> server name (can be the hostname) -# $u -> username (if guest, it's whatever user guest is running as) -# $v -> volume name (either ADEID_NAME or basename of path) -# $z -> zone (may not exist) -# $$ -> $ -# - -# -# casefold options [syntax: casefold:option]: -# tolower -> lowercases names in both directions -# toupper -> uppercases names in both directions -# xlatelower -> client sees lowercase, server sees uppercase -# xlateupper -> client sees uppercase, server sees lowercase -# -# allow/deny/rwlist/rolist format [syntax: allow:user1,@group]: -# user1,@group,user2 -> allows/denies access from listed users/groups -# rwlist/rolist control whether or not the -# volume is ro for those users. -# allowed_hosts -> Only listed hosts and networks are allowed, -# all others are rejected. Example: -# allowed_hosts:10.1.0.0/16,10.2.1.100 -# denied_hosts -> Listed hosts and nets are rejected, -# all others are allowed. Example: -# denied_hosts: 192.168.100/24,10.1.1.1 -# preexec -> command to be run when the volume is mounted, -# ignore for user defined volumes -# root_preexec -> command to be run as root when the volume is mounted, -# ignore for user defined volumes -# postexec -> command to be run when the volume is closed, -# ignore for user defined volumes -# root_postexec -> command to be run as root when the volume is closed, -# ignore for user defined volumes -# veto -> hide files and directories,where the path matches -# one of the "/" delimited vetoed names. Matches are -# partial, e.g. path is /abc/def/file and veto:/abc/ -# will hide the file. -# adouble -> specify the format of the metadata files. -# default is "v2". netatalk 1.x used "v1". -# "osx" cannot be treated normally any longer. -# volsizelimit -> size in MiB. Useful for TimeMachine: limits the -# reported volume size, thus preventing TM from using -# the whole real disk space for backup. -# Example: "volsizelimit:1000" would limit the -# reported disk space to 1 GB. - - -# -# codepage options [syntax: options:charsetname] -# volcharset -> specifies the charset to be used -# as the volume codepage -# e.g. "UTF8", "UTF8-MAC", "ISO-8859-15" -# maccharset -> specifies the charset to be used -# as the legacy client (<=Mac OS 9) codepage -# e.g. "MAC_ROMAN", "MAC_CYRILLIC" -# -# perm -> default permission value -# OR with the client requested perm -# Use with options:upriv -# dperm -> default permission value for directories -# OR with the client requested perm -# Use with options:upriv -# fperm -> default permission value for files -# OR with the client requested perm -# Use with options:upriv -# umask -> set perm mask -# Use with options:upriv -# dbpath:path -> store the database stuff in the following path. -# cnidserver:server[:port] -# -> Query this servername or IP address -# (default:localhost) and port (default: 4700) -# for CNIDs. Only used with CNID backend "dbd". -# This option here overrides any setting from -# afpd.conf:cnidserver. -# password:password -> set a volume password (8 characters max) -# cnidscheme:scheme -> set the cnid scheme for the volume, -# default is [:DEFAULT_CNID_SCHEME:] -# available schemes: [:COMPILED_BACKENDS:] -# ea -> none|auto|sys|ad -# Specify how Extended Attributes are stores. default -# is auto. -# auto: try "sys" (by setting an EA on the shared -# directory itself), fallback to "ad". Requires -# writable volume for performing the test. -# Note: options:ro overwrites "auto" with "none." -# sys: Use filesystem EAs -# ad: Use files in AppleDouble directories -# none: No EA support -# - -# -# miscellaneous options [syntax: options:option1,option2]: -# tm -> enable TimeMachine support -# prodos -> make compatible with appleII clients. -# crlf -> enable crlf translation for TEXT files. -# noadouble -> don't create .AppleDouble unless a resource -# fork needs to be created. -# ro -> mount the volume as read-only. -# mswindows -> enforce filename restrictions imposed by MS -# Windows. this will also invoke a default -# codepage (iso8859-1) if one isn't already -# specified. -# nohex -> don't do :hex translations for anything -# except dot files. specify usedots as well if -# you want that turned off. note: this option -# makes the / character illegal. -# usedots -> don't do :hex translation for dot files. note: when -# this option gets set, certain file names -# become illegal. these are .Parent and -# anything that starts with .Apple. -# invisibledots -> don't do :hex translation for dot files. note: when -# this option gets set, certain file names -# become illegal. these are .Parent and -# anything that starts with .Apple. also, dot -# files created on the unix side are marked invisible. -# limitsize -> limit disk size reporting to 2GB. this is -# here for older macintoshes using newer -# appleshare clients. yucko. -# nofileid -> don't advertise createfileid, resolveid, deleteid -# calls -# root_preexec_close -> a non-zero return code from root_preexec close the -# volume being mounted. -# preexec_close -> a non-zero return code from preexec close the -# volume being mounted. -# nostat -> don't stat volume path when enumerating volumes list -# upriv -> use unix privilege. -# illegalseq -> encode illegal sequence in filename asis, -# ex "\217-", which is not a valid SHIFT-JIS char, -# is encoded as U\217 - -# nocnidcache -> Don't store and read CNID to/from AppleDouble file. -# This should not be used as it also prevents a CNID -# database rebuild with `dbd`! -# caseinsensitive -> The underlying FS is case insensitive (only -# test with JFS in OS2 mode) -# dropbox -> Allows a volume to be declared as being a "dropbox." -# Note that netatalk must be compiled with dropkludge -# support for this to function. Warning: This option -# is deprecated and might not work as expected. -# dropkludge -> same as "dropbox" -# nodev -> always use 0 for device number, helps when the -# device number is not constant across a reboot, -# cluster, ... -# - -# The line below sets some DEFAULT, starting with Netatalk 2.1. -:DEFAULT: options:upriv,usedots - -# The "~" below indicates that Home directories are visible by default. -# If you do not wish to have people accessing their Home directories, -# please put a pound sign in front of the tilde or delete it. -~ - -# End of File diff --git a/config/AppleVolumes.system b/config/AppleVolumes.system deleted file mode 100644 index d75e4c94..00000000 --- a/config/AppleVolumes.system +++ /dev/null @@ -1,326 +0,0 @@ -# ($Id) -### -### Delete a '#' character at the head of line if you need. -### If clients are Mac OS X only, it is not especially necessary. -### However, it might be useful for Mac OS 9 or earlier. -### -### Use at your own risk. No guarantees express or implied. -### -### Try to use MacPerl script 'ICDumpSuffixMap' included in /usr/doc -### to download file mapping list from your Internet Config Preference. -### -### inoue@ma.ns.musashi-tech.ac.jp. -### - -### default translation -- note that CR <-> LF translation is done on all -### files of type TEXT (if crlf is set in volume's options). -### The first line turns off translation for files of unknown type, -### the third turns this translation on. -###. "????" "????" Unix Binary Unix application/octet-stream -###. "BINA" "UNIX" Unix Binary Unix application/octet-stream -###. "TEXT" "ttxt" ASCII Text SimpleText text/plain - -#.1st "TEXT" "ttxt" Text Readme SimpleText application/text -#.669 "6669" "SNPL" 669 MOD Music PlayerPro -#.8med "STrk" "SCPL" Amiga OctaMed music SoundApp -#.8svx "8SVX" "SCPL" Amiga 8-bit sound SoundApp -#.a "TEXT" "ttxt" Assembly Source SimpleText -#.aif "AIFF" "SCPL" AIFF Sound SoundApp audio/x-aiff -#.aifc "AIFC" "SCPL" AIFF Sound Compressed SoundApp audio/x-aiff -#.aiff "AIFF" "SCPL" AIFF Sound SoundApp audio/x-aiff -#.al "ALAW" "SCPL" ALAW Sound SoundApp -#.ani "ANIi" "GKON" Animated NeoChrome GraphicConverter -#.apd "TEXT" "ALD3" Aldus Printer Description Aldus PageMaker -#.arc "mArc" "SITx" PC ARChive StuffIt Expander -#.arj "BINA" "DArj" ARJ Archive DeArj -#.arr "ARR " "GKON" Amber ARR image GraphicConverter -#.art "ART " "GKON" First Publisher GraphicConverter -#.asc "TEXT" "ttxt" ASCII Text SimpleText text/plain -#.ascii "TEXT" "ttxt" ASCII Text SimpleText text/plain -#.asf "ASF_" "Ms01" Netshow Player Netshow Server video/x-ms-asf -#.asm "TEXT" "ttxt" Assembly Source SimpleText -#.asx "ASX_" "Ms01" Netshow Player Netshow Server video/x-ms-asf -#.au "ULAW" "TVOD" Sun Sound QuickTime Player audio/basic -#.avi "VfW " "TVOD" AVI Movie QuickTime Player video/avi -#.bar "BARF" "S691" Unix BAR Archive SunTar -#.bas "TEXT" "ttxt" BASIC Source SimpleText -#.bat "TEXT" "ttxt" MS-DOS Batch File SimpleText -#.bga "BMPp" "ogle" OS/2 Bitmap PictureViewer -#.bib "TEXT" "ttxt" BibTex Bibliography SimpleText -#.bin "SIT!" "SITx" MacBinary StuffIt Expander application/macbinary -#.binary "BINA" "hDmp" Untyped Binary Data HexEdit application/octet-stream -#.bmp "BMPp" "ogle" Windows Bitmap PictureViewer -#.boo "TEXT" "ttxt" BOO encoded SimpleText -#.bst "TEXT" "ttxt" BibTex Style SimpleText -#.bw "SGI " "GKON" SGI Image GraphicConverter -#.c "TEXT" "CWIE" C Source CodeWarrior -#.cgm "CGMm" "GKON" Computer Graphics Meta GraphicConverter -#.class "Clss" "CWIE" Java Class File CodeWarrior -#.clp "CLPp" "GKON" Windows Clipboard GraphicConverter -#.cmd "TEXT" "ttxt" OS/2 Batch File SimpleText -#.com "PCFA" "SWIN" MS-DOS Executable SoftWindows -#.cp "TEXT" "CWIE" C++ Source CodeWarrior -#.cpp "TEXT" "CWIE" C++ Source CodeWarrior -#.cpt "PACT" "SITx" Compact Pro Archive StuffIt Expander -#.csv "TEXT" "XCEL" Comma Separated Vars Excel -#.ct "..CT" "GKON" Scitex-CT GraphicConverter -#.cut "Halo" "GKON" Dr Halo Image GraphicConverter -#.cvs "drw2" "DAD2" Canvas Drawing Canvas -#.dbf "COMP" "FOX+" DBase Document FoxBase+ -#.dcx "DCXx" "GKON" Some PCX Images GraphicConverter -#.dif "TEXT" "XCEL" Data Interchange Format Excel -#.diz "TEXT" "R*Ch" BBS Descriptive Text BBEdit -#.dl "DL " "AnVw" DL Animation MacAnim Viewer -#.dll "PCFL" "SWIN" Windows DLL SoftWindows -#.doc "WDBN" "MSWD" Word Document Microsoft Word application/msword -#.dot "sDBN" "MSWD" Word for Windows Template Microsoft Word -#.dvi "ODVI" "xdvi" TeX DVI Document xdvi application/x-dvi -#.dwt "TEXT" "DmWr" Dreamweaver Template Dreamweaver -#.dxf "TEXT" "SWVL" AutoCAD 3D Data Swivel Pro -#.eps "EPSF" "vgrd" Postscript LaserWriter 8 application/postscript -#.epsf "EPSF" "vgrd" Postscript LaserWriter 8 application/postscript -#.etx "TEXT" "ezVu" SEText Easy View text/x-setext -#.evy "EVYD" "ENVY" Envoy Document Envoy -#.exe "PCFA" "SWIN" MS-DOS Executable SoftWindows -#.faq "TEXT" "ttxt" ASCII Text SimpleText text/x-usenet-faq -#.fit "FITS" "GKON" Flexible Image Transport GraphicConverter image/x-fits -#.flc "FLI " "TVOD" FLIC Animation QuickTime Player -#.fli "FLI " "TVOD" FLI Animation QuickTime Player -#.fm "FMPR" "FMPR" FileMaker Pro Database FileMaker Pro -#.for "TEXT" "MPS " Fortran Source MPW Shell -#.fts "FITS" "GKON" Flexible Image Transport GraphicConverter -#.gem "GEM-" "GKON" GEM Metafile GraphicConverter -#.gif "GIFf" "ogle" GIF Picture PictureViewer image/gif -#.gl "GL " "AnVw" GL Animation MacAnim Viewer -#.grp "GRPp" "GKON" GRP Image GraphicConverter -#.gz "SIT!" "SITx" Gnu ZIP Archive StuffIt Expander application/x-gzip -#.h "TEXT" "CWIE" C Include File CodeWarrior -#.hcom "FSSD" "SCPL" SoundEdit Sound ex SOX SoundApp -#.hp "TEXT" "CWIE" C Include File CodeWarrior -#.hpgl "HPGL" "GKON" HP GL/2 GraphicConverter -#.hpp "TEXT" "CWIE" C Include File CodeWarrior -#.hqx "TEXT" "SITx" BinHex StuffIt Expander application/mac-binhex40 -#.htm "TEXT" "MOSS" HyperText Netscape Communicator text/html -#.html "TEXT" "MOSS" HyperText Netscape Communicator text/html -#.i3 "TEXT" "R*ch" Modula 3 Interface BBEdit -#.ic1 "IMAG" "GKON" Atari Image GraphicConverter -#.ic2 "IMAG" "GKON" Atari Image GraphicConverter -#.ic3 "IMAG" "GKON" Atari Image GraphicConverter -#.icn "ICO " "GKON" Windows Icon GraphicConverter -#.ico "ICO " "GKON" Windows Icon GraphicConverter -#.ief "IEF " "GKON" IEF image GraphicConverter image/ief -#.iff "ILBM" "GKON" Amiga IFF Image GraphicConverter -#.ilbm "ILBM" "GKON" Amiga ILBM Image GraphicConverter -#.image "dImg" "ddsk" Apple DiskCopy Image Disk Copy -#.img "IMGg" "GKON" GEM bit image/XIMG GraphicConverter -#.ini "TEXT" "ttxt" Windows INI File SimpleText -#.java "TEXT" "CWIE" Java Source File CodeWarrior -#.jfif "JPEG" "ogle" JFIF Image PictureViewer -#.jpe "JPEG" "ogle" JPEG Picture PictureViewer image/jpeg -#.jpeg "JPEG" "ogle" JPEG Picture PictureViewer image/jpeg -#.jpg "JPEG" "ogle" JPEG Picture PictureViewer image/jpeg -#.latex "TEXT" "OTEX" Latex OzTex application/x-latex -#.lbm "ILBM" "GKON" Amiga IFF Image GraphicConverter -#.lha "LHA " "SITx" LHArc Archive StuffIt Expander -#.lzh "LHA " "SITx" LHArc Archive StuffIt Expander -#.m1a "MPEG" "TVOD" MPEG-1 audiostream MoviePlayer audio/x-mpeg -#.m1s "MPEG" "TVOD" MPEG-1 systemstream MoviePlayer -#.m1v "M1V " "TVOD" MPEG-1 IPB videostream MoviePlayer video/mpeg -#.m2 "TEXT" "R*ch" Modula 2 Source BBEdit -#.m2v "MPG2" "MPG2" MPEG-2 IPB videostream MPEG2decoder -#.m3 "TEXT" "R*ch" Modula 3 Source BBEdit -#.mac "PICT" "ogle" PICT Picture PictureViewer image/x-pict -#.mak "TEXT" "R*ch" Makefile BBEdit -#.mcw "WDBN" "MSWD" Mac Word Document Microsoft Word -#.me "TEXT" "ttxt" Text Readme SimpleText -#.med "STrk" "SCPL" Amiga MED Sound SoundApp -#.mf "TEXT" "*MF*" Metafont Metafont -#.mid "Midi" "TVOD" MIDI Music MoviePlayer -#.midi "Midi" "TVOD" MIDI Music MoviePlayer -#.mif "TEXT" "Fram" FrameMaker MIF FrameMaker application/x-framemaker -#.mime "TEXT" "SITx" MIME Message StuffIt Expander message/rfc822 -#.ml "TEXT" "R*ch" ML Source BBEdit -#.mod "STrk" "SCPL" MOD Music SoundApp -#.mol "TEXT" "RSML" MDL Molfile RasMac -#.moov "MooV" "TVOD" QuickTime Movie MoviePlayer video/quicktime -#.mov "MooV" "TVOD" QuickTime Movie MoviePlayer video/quicktime -#.mp2 "MPEG" "TVOD" MPEG-1 audiostream MoviePlayer audio/x-mpeg -#.mp3 "MPG3" "TVOD" MPEG-3 audiostream MoviePlayer audio/x-mpeg -#.mpa "MPEG" "TVOD" MPEG-1 audiostream MoviePlayer audio/x-mpeg -#.mpe "MPEG" "TVOD" MPEG Movie of some sort MoviePlayer video/mpeg -#.mpeg "MPEG" "TVOD" MPEG Movie of some sort MoviePlayer video/mpeg -#.mpg "MPEG" "TVOD" MPEG Movie of some sort MoviePlayer video/mpeg -#.msp "MSPp" "GKON" Microsoft Paint GraphicConverter -#.mtm "MTM " "SNPL" MultiMOD Music PlayerPro -#.mw "MW2D" "MWII" MacWrite Document MacWrite II application/macwriteii -#.mwii "MW2D" "MWII" MacWrite Document MacWrite II application/macwriteii -#.neo "NeoC" "GKON" Atari NeoChrome GraphicConverter -#.nfo "TEXT" "ttxt" Info Text SimpleText application/text -#.nst "STrk" "SCPL" MOD Music SoundApp -#.obj "PCFL" "SWIN" Object (DOS/Windows) SoftWindows -#.oda "ODIF" "ODA " ODA Document MacODA XTND Translator application/oda -#.okt "OKTA" "SCPL" Oktalyser MOD Music SoundApp -#.out "BINA" "hDmp" Output File HexEdit -#.ovl "PCFL" "SWIN" Overlay (DOS/Windows) SoftWindows -#.p "TEXT" "CWIE" Pascal Source CodeWarrior -#.pac "STAD" "GKON" Atari STAD Image GraphicConverter -#.pas "TEXT" "CWIE" Pascal Source CodeWarrior -#.pbm "PPGM" "GKON" Portable Bitmap GraphicConverter image/x-portable-bitmap -#.pc1 "Dega" "GKON" Atari Degas Image GraphicConverter -#.pc2 "Dega" "GKON" Atari Degas Image GraphicConverter -#.pc3 "Dega" "GKON" Atari Degas Image GraphicConverter -#.pcs "PICS" "GKON" Animated PICTs GraphicConverter -#.pct "PICT" "ogle" PICT Picture PictureViewer image/x-pict -#.pcx "PCXx" "GKON" PC PaintBrush GraphicConverter -#.pdb "TEXT" "RSML" Brookhaven PDB file RasMac -#.pdf "PDF " "CARO" Portable Document Format Acrobat Reader application/pdf -#.pdx "TEXT" "ALD5" Printer Description PageMaker -#.pf "CSIT" "SITx" Private File StuffIt Expander -#.pgm "PPGM" "GKON" Portable Graymap GraphicConverter image/x-portable-graymap -#.pi1 "Dega" "GKON" Atari Degas Image GraphicConverter -#.pi2 "Dega" "GKON" Atari Degas Image GraphicConverter -#.pi3 "Dega" "GKON" Atari Degas Image GraphicConverter -#.pic "PICT" "ogle" PICT Picture PictureViewer image/x-pict -#.pict "PICT" "ogle" PICT Picture PictureViewer image/x-macpict -#.pit "PIT " "SITx" PackIt Archive StuffIt Expander -#.pkg "HBSF" "SITx" AppleLink Package StuffIt Expander -#.pl "TEXT" "McPL" Perl Source MacPerl -#.plt "HPGL" "GKON" HP GL/2 GraphicConverter -#.pm "PMpm" "GKON" Bitmap from xv GraphicConverter -#.pm3 "ALB3" "ALD3" PageMaker 3 Document PageMaker -#.pm4 "ALB4" "ALD4" PageMaker 4 Document PageMaker -#.pm5 "ALB5" "ALD5" PageMaker 5 Document PageMaker -#.png "PNG " "ogle" Portable Network Graphic PictureViewer -#.pntg "PNTG" "ogle" Macintosh Painting PictureViewer -#.ppd "TEXT" "ALD5" Printer Description PageMaker -#.ppm "PPGM" "GKON" Portable Pixmap GraphicConverter image/x-portable-pixmap -#.prn "TEXT" "R*ch" Printer Output File BBEdit -#.ps "TEXT" "vgrd" PostScript LaserWriter 8 application/postscript -#.psd "8BPS" "8BIM" PhotoShop Document Photoshop -#.pt4 "ALT4" "ALD4" PageMaker 4 Template PageMaker -#.pt5 "ALT5" "ALD5" PageMaker 5 Template PageMaker -#.pxr "PXR " "8BIM" Pixar Image Photoshop -#.qdv "QDVf" "GKON" QDV image GraphicConverter -#.qt "MooV" "TVOD" QuickTime Movie MoviePlayer video/quicktime -#.qxd "XDOC" "XPR3" QuarkXpress Document QuarkXpress -#.qxt "XTMP" "XPR3" QuarkXpress Template QuarkXpress -#.raw "BINA" "GKON" Raw Image GraphicConverter -#.readme "TEXT" "ttxt" Text Readme SimpleText application/text -#.rgb "SGI " "GKON" SGI Image GraphicConverter image/x-rgb -#.rgba "SGI " "GKON" SGI Image GraphicConverter image/x-rgb -#.rib "TEXT" "RINI" Renderman 3D Data Renderman -#.rif "RIFF" "GKON" RIFF Graphic GraphicConverter -#.rle "RLE " "GKON" RLE image GraphicConverter -#.rme "TEXT" "ttxt" Text Readme SimpleText -#.rpl "FRL!" "REP!" Replica Document Replica -#.rsc "rsrc" "RSED" Resource File ResEdit -#.rsrc "rsrc" "RSED" Resource File ResEdit -#.rtf "TEXT" "MSWD" Rich Text Format Microsoft Word application/rtf -#.rtx "TEXT" "R*ch" Rich Text BBEdit text/richtext -#.s3m "S3M " "SNPL" ScreamTracker 3 MOD PlayerPro -#.scc "MSX " "GKON" MSX pitcure GraphicConverter -#.scg "RIX3" "GKON" ColoRIX GraphicConverter -#.sci "RIX3" "GKON" ColoRIX GraphicConverter -#.scp "RIX3" "GKON" ColoRIX GraphicConverter -#.scr "RIX3" "GKON" ColoRIX GraphicConverter -#.scu "RIX3" "GKON" ColoRIX GraphicConverter -#.sea "APPL" "????" Self-Extracting Archive Self Extracting Archive -#.sf "IRCM" "SDHK" IRCAM Sound SoundHack -#.sgi ".SGI" "ogle" SGI Image PictureViewer -#.sha "TEXT" "UnSh" Unix Shell Archive UnShar application/x-shar -#.shar "TEXT" "UnSh" Unix Shell Archive UnShar application/x-shar -#.shp "SHPp" "GKON" Printmaster Icon Library GraphicConverter -#.sit "SIT!" "SITx" StuffIt 1.5.1 Archive StuffIt Expander application/x-stuffit -#.sithqx "TEXT" "SITx" BinHexed StuffIt Archive StuffIt Expander application/mac-binhex40 -#.six "SIXE" "GKON" SIXEL image GraphicConverter -#.slk "TEXT" "XCEL" SYLK Spreadsheet Excel -#.snd "BINA" "SCPL" Sound of various types SoundApp -#.spc "Spec" "GKON" Atari Spectrum 512 GraphicConverter -#.sr "SUNn" "GKON" Sun Raster Image GraphicConverter -#.sty "TEXT" "*TEX" TeX Style Textures -#.sun "SUNn" "GKON" Sun Raster Image GraphicConverter -#.sup "SCRN" "GKON" StartupScreen GraphicConverter -#.svx "8SVX" "SCPL" Amiga IFF Sound SoundApp -#.syk "TEXT" "XCEL" SYLK Spreadsheet Excel -#.sylk "TEXT" "XCEL" SYLK Spreadsheet Excel -#.tar "TARF" "SITx" Unix Tape ARchive StuffIt Expander application/x-tar -#.targa "TPIC" "GKON" Truevision Image GraphicConverter -#.taz "ZIVU" "SITx" Compressed Tape ARchive StuffIt Expander application/x-compress -#.tex "TEXT" "OTEX" TeX Document OzTeX application/x-tex -#.texi "TEXT" "OTEX" TeX Document OzTeX -#.texinfo "TEXT" "OTEX" TeX Document OzTeX application/x-texinfo -#.text "TEXT" "ttxt" ASCII Text SimpleText text/plain -#.tga "TPIC" "GKON" Truevision Image GraphicConverter -#.tgz "Gzip" "SITx" Gnu ZIPed Tape ARchive StuffIt Expander application/x-gzip -#.tif "TIFF" "ogle" TIFF Picture PictureViewer image/tiff -#.tiff "TIFF" "ogle" TIFF Picture PictureViewer image/tiff -#.tny "TINY" "GKON" Atari TINY Bitmap GraphicConverter -#.tsv "TEXT" "XCEL" Tab Separated Values Excel text/tab-separated-values -#.tx8 "TEXT" "ttxt" 8-bit ASCII Text SimpleText -#.txt "TEXT" "ttxt" ASCII Text SimpleText text/plain -#.ul "ULAW" "TVOD" Mu-Law Sound MoviePlayer audio/basic -#.url "AURL" "Arch" URL Bookmark Anarchie message/external-body -#.uu "TEXT" "SITx" UUEncode StuffIt Expander -#.uue "TEXT" "SITx" UUEncode StuffIt Expander -#.vff "VFFf" "GKON" DESR VFF Greyscale Image GraphicConverter -#.vga "BMPp" "ogle" OS/2 Bitmap PictureViewer -#.voc "VOC " "SCPL" VOC Sound SoundApp -#.w51 ".WP5" "WPC2" WordPerfect PC 5.1 Doc WordPerfect application/wordperfect5.1 -#.wav "WAVE" "TVOD" Windows WAV Sound MoviePlayer audio/x-wav -#.wk1 "XLBN" "XCEL" Lotus Spreadsheet r2.1 Excel -#.wks "XLBN" "XCEL" Lotus Spreadsheet r1.x Excel -#.wmf "WMF " "GKON" Windows Metafile GraphicConverter -#.wp ".WP5" "WPC2" WordPerfect PC 5.1 Doc WordPerfect application/wordperfect5.1 -#.wp4 ".WP4" "WPC2" WordPerfect PC 4.2 Doc WordPerfect -#.wp5 ".WP5" "WPC2" WordPerfect PC 5.x Doc WordPerfect application/wordperfect5.1 -#.wp6 ".WP6" "WPC2" WordPerfect PC 6.x Doc WordPerfect -#.wpg "WPGf" "GKON" WordPerfect Graphic GraphicConverter -#.wpm "WPD1" "WPC2" WordPerfect Mac WordPerfect -#.wri "WDBN" "MSWD" MS Write/Windows Microsoft Word -#.wve "BINA" "SCPL" PSION sound SoundApp -#.x10 "XWDd" "GKON" X-Windows Dump GraphicConverter image/x-xwd -#.x11 "XWDd" "GKON" X-Windows Dump GraphicConverter image/x-xwd -#.xbm "XBM " "GKON" X-Windows Bitmap GraphicConverter image/x-xbm -#.xl "XLS " "XCEL" Excel Spreadsheet Excel -#.xlc "XLC " "XCEL" Excel Chart Excel -#.xlm "XLM " "XCEL" Excel Macro Excel -#.xls "XLS " "XCEL" Excel Spreadsheet Excel -#.xlw "XLW " "XCEL" Excel Workspace Excel -#.xm "XM " "SNPL" FastTracker MOD Music PlayerPro -#.xpm "XPM " "GKON" X-Windows Pixmap GraphicConverter image/x-xpm -#.xwd "XWDd" "GKON" X-Windows Dump GraphicConverter image/x-xwd -#.Z "ZIVU" "SITx" Unix Compress Archive StuffIt Expander application/x-compress -#.zip "ZIP " "SITx" PC ZIP Archive StuffIt Expander application/zip -#.zoo "Zoo " "Booz" Zoo Archive MacBooz - -### Last Updated Jan 2, 2002 -### Use at your own risk. Take care ! -### -### I'd like to dedicate this as follows code to Miss.Tamaki Imazu -### -### Kazuhiko Okudaira the Nursery Teacher -### kokudaira@hotmail.com - -#.bld "BLD " "GKON" BLD GraphicConverter -#.bum ".bMp" "GKON" QuickTime Importer(QuickDraw) GraphicConverter -#.cel "CEL " "GKON" KISS CEL GraphicConverter -#.cur "CUR " "GKON" Windows Cursor GraphicConverter -#.cwj "CWSS" "cwkj" ClarisWorks Document ClarisWorks 4.0 -#.dat "TCLl" "GKON" TCL image GraphicConverter -#.hr "TR80" "GKON" TSR-80 HR GraphicConverter -#.iss "ISS " "GKON" ISS GraphicConverter -#.jif "JIFf" "GKON" JIF99a GraphicConverter -#.lwf "lwfF" "GKON" LuraWave(LWF) GraphicConverter -#.mbm "MBM " "GKON" PSION 5(MBM) GraphicConverter -#.ngg "NGGC" "GKON" Mobile Phone(Nokia)Format GraphicConverter -#.nol "NOL " "GKON" Mobile Phone(Nokia)Format GraphicConverter -#.pal "8BCT" "8BIM" Color Table GraphicConverter -#.pgc "PGCF" "GKON" PGC/PGF Atari Portfolio PCG GraphicConverter -#.pics "PICS" "GKON" PICS-PICT Sequence GraphicConverter -#.swf "SWFL" "SWF2" Flash Macromedia Flash -#.vpb "VPB " "GKON" VPB QUANTEL GraphicConverter -#.wbmp "WBMP" "GKON" WBMP GraphicConverter -#.x-face "TEXT" "GKON" X-Face GraphicConverter - -### Nov 29, 2002 -#.fla "SPA " "MFL2" Flash source Macromedia Flash diff --git a/config/Makefile.am b/config/Makefile.am index bd503aeb..5b2b2575 100644 --- a/config/Makefile.am +++ b/config/Makefile.am @@ -3,35 +3,16 @@ SUBDIRS = pam SUFFIXES = .tmpl . -TMPLFILES = afpd.conf.tmpl AppleVolumes.default.tmpl -GENFILES = afpd.conf AppleVolumes.default +TMPLFILES = +GENFILES = CLEANFILES = $(GENFILES) -EXTRA_DIST = \ - AppleVolumes.default.tmpl \ - AppleVolumes.system \ - afp_ldap.conf \ - afpd.conf.tmpl \ - netatalk.conf +EXTRA_DIST = afp.conf OVERWRITE_CONFIG = @OVERWRITE_CONFIG@ -if USE_DEBIAN -CONFFILES = AppleVolumes.system -else -CONFFILES = AppleVolumes.system netatalk.conf -endif - -if HAVE_ACLS -CONFFILES += afp_ldap.conf -endif +CONFFILES = afp.conf pkgconfdir = @PKGCONFDIR@ -webminpath = @WEBMIN_PATH@ -webminuser = @WEBMIN_USER@ -webminversion = @WEBMIN_VERSION@ -webminpass = @WEBMIN_PASS@ -webminport = @WEBMIN_PORT@ - # # rule to parse template files # @@ -68,70 +49,3 @@ install-config-files: $(CONFFILES) $(GENFILES) echo "not overwriting $$f"; \ fi; \ done -if USE_DEBIAN - $(mkinstalldirs) $(DESTDIR)/etc/default - if test "x$(OVERWRITE_CONFIG)" = "xyes" -o ! -f /etc/default/netatalk; then \ - echo "$(INSTALL_DATA) $(srcdir)/netatalk.conf $(DESTDIR)/etc/default/netatalk"; \ - $(INSTALL_DATA) $(srcdir)/netatalk.conf $(DESTDIR)/etc/default/netatalk; \ - else \ - echo "not overwriting /etc/default/netatalk"; \ - fi -endif - -install-webmin: - if test "x$(webminpath)" != "x"; then \ - if ! test -d "x$(webminpath)"; then \ - mkdir -p "$(webminpath)"; \ - fi; \ - cd "$(webminpath)"; \ - wget http://prdownloads.sourceforge.net/webadmin/webmin-$(webminversion).tar.gz ; \ - tar xzf webmin-$(webminversion).tar.gz; \ - rm webmin-$(webminversion).tar.gz; \ - /etc/init.d/webmin stop; \ - rm -r webmin; \ - mv webmin-$(webminversion) webmin; \ - cd webmin; \ - rm -r adsl-client apache at backup-config bacula-backup bandwidth bind8 bsdexports burner \ - cfengine cluster-copy cluster-cron cluster-passwd cluster-shell cluster-software cluster-useradmin \ - cluster-usermin cluster-webmin custom \ - cron dfsadmin dhcpd dnsadmin dovecot exim exports \ - fdisk fetchmail file filter firewall format frox fsdump grub heartbeat hpuxexports \ - htaccess-htpasswd idmapd inetd inittab ipfilter ipfw ipsec jabber \ - ldap-server lilo logrotate lpadmin lvm \ - mailboxes mailcap majordomo man mon mscstyle3 mysql \ - net nis openslp pap phpini postfix postgresql ppp-client pptp-client pptp-server \ - procmail proftpd pserver qmailadmin raid rbac \ - samba sarg sendmail sentry sgiexports shell \ - shorewall smart-status smf software spam squid sshd \ - status stunnel tcpwrappers telnet time tunnel \ - updown usermin vgetty webalizer wuftpd xinetd zones; \ - wget https://sourceforge.net/projects/netatalk/files/Netatalk%20Webmin%20Module/0.9-beta2/netatalk.wbm.gz/download ; \ - tar xzf netatalk.wbm.gz; \ - rm netatalk.wbm.gz; \ - cd netatalk; \ - rm config; \ - echo "applevolumedefault_c=$(sysconfdir)/netatalk/AppleVolumes.default" >> config; \ - echo "applevolumesystem_c=$(sysconfdir)/netatalk/AppleVolumes.system" >> config; \ - echo "afpd_c=$(sysconfdir)/netatalk/afpd.conf" >> config; \ - echo "atalk_c=$(sysconfdir)/netatalk/atalk.conf" >> config; \ - echo "papd_c=$(sysconfdir)/netatalk/papd.conf" >> config; \ - echo "afpd_d=$(sbindir)/afpd" >> config; \ - echo "atalkd_d=$(sbindir)/atalkd" >> config; \ - echo "papd_d=$(sbindir)/papd" >> config; \ - echo "netatalk_c=@PAMDIR@/etc/pam.d" >> config; \ - echo "atalk_start=$(sysconfdir)/init.d/atalk" >> config; \ - echo "select_minUsers=" >> config; \ - echo "select_maxUsers=" >> config; \ - echo "atalk_nls=" >> config; \ - cd ..; \ - config_dir="$(sysconfdir)/netatalk/webmin-config" \ - var_dir="$(prefix)/var" \ - perl="`which perl`" \ - port="$(webminport)" \ - login="$(webminuser)" \ - password="$(webminpass)" \ - ssl=1 \ - atboot=1 \ - bootscript=netamin \ - ./setup.sh > /dev/null; \ - fi diff --git a/config/afp.conf b/config/afp.conf new file mode 100644 index 00000000..f7026449 --- /dev/null +++ b/config/afp.conf @@ -0,0 +1,19 @@ +; +; Netatalk configuration file +; + +[Global] + +; Global server settings + +[AFP] + +; AFP server settings + +[CNID] + +; CNID server settings + +; [My AFP Volume] +; +; path = /path/to/volume diff --git a/config/afpd.conf.tmpl b/config/afpd.conf.tmpl deleted file mode 100644 index 71f2d50b..00000000 --- a/config/afpd.conf.tmpl +++ /dev/null @@ -1,362 +0,0 @@ -# -# CONFIGURATION FOR AFPD -# -# Each single line defines a virtual server that should be available. -# Though, using "\" character, newline escaping is supported. -# Empty lines and lines beginning with `#' are ignored. -# Options in this file will override both compiled-in defaults -# and command line options. -# - - -# -# Format: -# - [options] to specify options for the default server -# "Server name" [options] to specify an additional server -# - - -# -# The following options are available: -# Transport Protocols: -# -[no]tcp Make "AFP over TCP" [not] available -# -[no]ddp Make "AFP over AppleTalk" [not] available. -# If you have -proxy specified, specify -uamlist "" to -# prevent ddp connections from working. -# -# -transall Make both available -# -# Transport Options: -# -ipaddr Specifies the IP address that the server should -# advertise and listens to. The default is advertise -# the first IP address of the system, but to listen -# for any incoming request. The network address may -# be specified either in dotted-decimal format for -# IPv4 or in hexadecimal format for IPv6. -# This option also allows to use one machine to -# advertise the AFP-over-TCP/IP settings of another -# machine via NBP when used together with the -proxy -# option. -# -server_quantum -# Specifies the DSI server quantum. The minimum -# value is 1MB. The max value is 0xFFFFFFFF. If you -# specify a value that is out of range, you'll get -# the default value (currently the minimum). -# -admingroup -# Specifies the group of administrators who should -# all be seen as the superuser when they log in. -# Default is disabled. -# -ddpaddr x.y Specifies the DDP address of the server. -# the default is to auto-assign an address (0.0). -# this is only useful if you're running on -# a multihomed host. -# -port Specifies the TCP port the server should respond -# to (default is 548) -# -fqdn specify a fully-qualified domain name (+optional -# port). this gets discarded if the server can't -# resolve it. this is not honored by appleshare -# clients <= 3.8.3 (default: none) -# -hostname Use this instead of the result from calling -# hostname for dertermening which IP address to -# advertise, therfore the hostname is resolved to -# an IP which is the advertised. This is NOT used for -# listening and it is also overwritten by -ipaddr. -# -proxy Run an AppleTalk proxy server for specified -# AFP/TCP server (if address/port aren't given, -# then first IP address of the system/548 will -# be used). -# if you don't want the proxy server to act as -# a ddp server as well, set -uamlist to an empty -# string. -# -dsireadbuf [number] -# Scale factor that determines the size of the -# DSI/TCP readahead buffer, default is 12. This is -# multiplies with the DSI server quantum (default -# ~300k) to give the size of the buffer. Increasing -# this value might increase throughput in fast local -# networks for volume to volume copies. Note: This -# buffer is allocated per afpd child process, so -# specifying large values will eat up large amount of -# memory (buffer size * number of clients). -# -tcprcvbuf [number] -# Try to set TCP receive buffer using setsockpt(). -# Often OSes impose restrictions on the applications -# ability to set this value. -# -tcpsndbuf [number] -# Try to set TCP send buffer using setsockpt(). -# Often OSes impose restrictions on the applications -# ability to set this value. -# -slp Register this server with the Service Location -# Protocol (if SLP support was compiled in). -# -nozeroconf Don't register this server with the Multicats -# DNS Protocol. -# -advertise_ssh Allows Mac OS X clients (10.3.3-10.4) to -# automagically establish a tunneled AFP connection -# through SSH. This option is not so significant -# for the recent Mac OS X. See the Netatalk Manual -# in detail. -# -# -# Authentication Methods: -# -uampath Use this path to look for User Authentication Modules. -# (default: :UAMS_PATH:) -# -uamlist Comma-separated list of UAMs. -# (default: uams_dhx.so,uams_dhx2.so) -# -# some commonly available UAMs: -# uams_guest.so: Allow guest logins -# -# uams_clrtxt.so: (uams_pam.so or uams_passwd.so) -# Allow logins with passwords -# transmitted in the clear. -# -# uams_randnum.so: Allow Random Number and Two-Way -# Random Number exchange for -# authentication. -# -# uams_dhx.so: (uams_dhx_pam.so or uams_dhx_passwd.so) -# Allow Diffie-Hellman eXchange -# (DHX) for authentication. -# -# uams_dhx2.so: (uams_dhx2_pam.so or uams_dhx2_passwd.so) -# Allow Diffie-Hellman eXchange 2 -# (DHX2) for authentication. -# -# Password Options: -# -[no]savepassword [Don't] Allow clients to save password locally -# -passwdfile Use this path to store Randnum passwords. -# (Default: :ETCDIR:/afppasswd. The only other -# useful value is ~/.passwd. See 'man afppasswd' -# for details.) -# -passwdminlen <#> minimum password length. may be ignored. -# -[no]setpassword [Don't] Allow clients to change their passwords. -# -loginmaxfail <#> maximum number of failed logins. this may be -# ignored if the uam can't handle it. -# -# AppleVolumes files: -# -defaultvol Specifies path to AppleVolumes.default file -# (default :ETCDIR:/AppleVolumes.default, -# same as -f on command line) -# -systemvol Specifies path to AppleVolumes.system file -# (default :ETCDIR:/AppleVolumes.system, -# same as -s on command line) -# -[no]uservolfirst [Don't] read the user's ~/AppleVolumes or -# ~/.AppleVolumes before reading -# :ETCDIR:/AppleVolumes.default -# (same as -u on command line) -# -[no]uservol [Don't] Read the user's volume file -# -closevol Immediately unmount volumes removed from -# AppleVolumes files on SIGHUP sent to the afp -# master process. -# -# Miscellaneous: -# -authprintdir Specifies the path to be used (per server) to -# store the files required to do CAP-style -# print authentication which papd will examine -# to determine if a print job should be allowed. -# These files are created at login and if they -# are to be properly removed, this directory -# probably needs to be umode 1777 -# -guestname "user" Specifies the user name for the guest login -# (default "nobody", same as -g on command line) -# -loginmesg "Message" Client will display "Message" upon logging in -# (no default, same as -l "Message" on commandline) -# -nodebug Switch off debugging -# -client_polling With this switch enabled, afpd won't advertise -# that it is capable of server notifications, so that -# connected clients poll the server every 10 seconds -# to detect changes in opened server windows. -# Note: Depending on the number of simultaneously -# connected clients and the network's speed, this can -# lead to a significant higher load on your network! -# -sleep AFP 3.x wait number hours before disconnecting -# clients in sleep mode. Default 10 hours -# -tickleval Specify the tickle timeout interval (in seconds). -# Note, this defaults to 30 seconds, and really -# shouldn't be changed. If you want to control -# the server idle timeout, use the -timeout option. -# -timeout Specify the number of tickles to send before -# timing out a connection. -# The default is 4, therefore a connection will -# timeout in 2 minutes. -# -[no]icon [Don't] Use the platform-specific icon. Recent -# Mac OS don't display it any longer. -# -volnamelen -# Max length of UTF8-MAC volume name for Mac OS X. -# Note that Hangul is especially sensitive to this. -# 255: limit of spec -# 80: limit of generic Mac OS X (default) -# 73: limit of Mac OS X 10.1, if >= 74 -# Finder crashed and restart repeatedly. -# Mac OS 9 and earlier is not influenced by this, -# Maccharset volume names are always limitted to 27. -# -[un]setuplog " []" -# Specify that any message of a loglevel up to the -# given loglevel should be logged to the given file. -# If the filename is ommited the loglevel applies to -# messages passed to syslog. -# -# By default (no explicit -setuplog and no buildtime -# configure flag --with-logfile) afpd logs to syslog -# with a default logging setup equivalent to -# "-setuplog default log_info". -# -# If build with --with-logfile[=somefile] -# (default logfile /var/log/netatalk.log) afpd -# defaults to a setup that is equivalent to -# "-setuplog default log_info [netatalk.log|somefile]" -# -# logtypes: Default, AFPDaemon, Logger, UAMSDaemon -# loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, -# LOG_NOTE, LOG_INFO, LOG_DEBUG, -# LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, -# LOG_DEBUG9, LOG_MAXDEBUG -# -# Example: Useful default config -# -setuplog "default log_info /var/log/afpd.log" -# -# Debugging config -# -setuplog "default log_maxdebug /var/log/afpd.log" -# -# -signature { user: | auto } -# Specify a server signature. This option is useful -# while running multiple independent instances of -# afpd on one machine (eg. in clustered environments, -# to provide fault isolation etc.). -# Default is "auto". -# "auto" signature type allows afpd generating -# signature and saving it to afp_signature.conf -# automatically (based on random number). -# "host" signature type switches back to "auto" -# because it is obsoleted. -# "user" signature type allows administrator to -# set up a signature string manually. -# Examples: three servers running on one machine: -# first -signature user:USERS -# second -signature user:USERS -# third -signature user:ADMINS -# First two servers will act as one logical AFP -# service. If user logs in to first one and then -# connects to second one, session will be -# automatically redirected to the first one. But if -# client connects to first and then to third, -# will be asked for password twice and will see -# resources of both servers. -# Traditional method of signature generation causes -# two independent afpd instances to have the same -# signature and thus cause clients to be redirected -# automatically to server (s)he logged in first. -# -k5keytab -# -k5service -# -k5realm -# These are required if the server supports -# Kerberos 5 authentication -# -ntdomain -# -ntseparator -# Use for eg. winbind authentication, prepends -# both strings before the username from login and -# then tries to authenticate with the result -# through the availabel and active UAM authentication -# modules. -# -dircachesize entries -# Maximum possible entries in the directory cache. -# The cache stores directories and files. It is used -# to cache the full path to directories and CNIDs -# which considerably speeds up directory enumeration. -# Default size is 8192, maximum size is 131072. Given -# value is rounded up to nearest power of 2. Each -# entry takes about 100 bytes, which is not much, but -# remember that every afpd child process for every -# connected user has its cache. -# -fcelistener host[:port] -# Enables sending FCE events to the specified host, -# default port is 12250 if not specified. Specifying -# mutliple listeners is done by having this option -# once for each of them. -# -fceevents fmod,fdel,ddel,fcre,dcre,tmsz -# Speficies which FCE events are active, default is -# fmod,fdel,ddel,fcre,dcre. -# -fcecoalesce all|delete|create -# Coalesce FCE events. -# -fceholdfmod seconds -# This determines the time delay in seconds which is -# always waited if another file modification for the -# same file is done by a client before sending an FCE -# file modification event (fmod). For example saving -# a file in Photoshop would generate multiple events -# by itself because the application is opening, -# modifying and closing a file mutliple times for -# every "save". Defautl: 60 seconds. -# -keepsessions Enable "Continuous AFP Service". This means the -# ability to stop the master afpd process with a -# SIGQUIT signal, possibly install an afpd update and -# start the afpd process. Existing AFP sessions afpd -# processes will remain unaffected. Technically they -# will be notified of the master afpd shutdown, sleep -# 15-20 seconds and then try to reconnect their IPC -# channel to the master afpd process. If this -# reconnect fails, the sessions are in an undefined -# state. Therefor it's absolutely critical to restart -# the master process in time! -# -noacl2maccess Don't map filesystem ACLs to effective permissions. -# -# Codepage Options: -# -unixcodepage Specifies the servers unix codepage, -# e.g. "ISO-8859-15" or "UTF8". -# This is used to convert strings to/from -# the systems locale, e.g. for authenthication. -# Defaults to LOCALE if your system supports it, -# otherwise ASCII will be used. -# -# -maccodepage Specifies the legacy clients (<= Mac OS 9) -# codepage, e.g. "MAC_ROMAN". -# This is used to convert strings to the -# systems locale, e.g. for authenthication -# and SIGUSR2 messaging. This will also be -# the default for volumes maccharset. -# -# CNID related options: -# -cnidserver -# Specifies the IP address and port of a -# cnid_metad server, required for CNID dbd -# backend. Defaults to localhost:4700. -# The network address may be specified either -# in dotted-decimal format for IPv4 or in -# hexadecimal format for IPv6. -# -# Avahi (Bonjour) related options: -# -mimicmodel -# Specifies the icon model that appears on -# clients. Defaults to off. Examples: RackMac -# (same as Xserve), PowerBook, PowerMac, Macmini, -# iMac, MacBook, MacBookPro, MacBookAir, MacPro, -# AppleTV1,1, AirPort -# - - -# -# Some examples: -# -# The simplest case is to not have an afpd.conf. -# -# 4 servers w/ names server1-3 and one w/ the hostname. servers -# 1-3 get routed to different ports with server 3 being bound -# specifically to address 192.168.1.3 -# -# - -# server1 -port 12000 -# server2 -port 12001 -# server3 -port 12002 -ipaddr 192.168.1.3 -# -# a dedicated guest server, a user server, and a special -# AppleTalk-only server: -# -# "Guest Server" -uamlist uams_guest.so \ -# -loginmesg "Welcome guest! I'm a public server." -# "User Server" -uamlist uams_dhx2.so -port 12000 -# "special" -ddp -notcp -defaultvol -systemvol -# - - -# default: -# - -tcp -noddp -uamlist uams_dhx.so,uams_dhx2.so -nosavepassword diff --git a/config/netatalk.conf b/config/netatalk.conf deleted file mode 100644 index cb873a3e..00000000 --- a/config/netatalk.conf +++ /dev/null @@ -1,61 +0,0 @@ -# Netatalk configuration - -######################################################################### -# Global configuration -######################################################################### - -#### machine's AFPserver/AppleTalk name. -#ATALK_NAME=machinename - -#### server (unix) and legacy client (<= Mac OS 9) charsets -ATALK_UNIX_CHARSET='LOCALE' -ATALK_MAC_CHARSET='MAC_ROMAN' - -#### Don't Edit. export the charsets, read form ENV by apps -export ATALK_UNIX_CHARSET -export ATALK_MAC_CHARSET - -######################################################################### -# AFP specific configuration -######################################################################### - -#### Set which daemons to run. -#### If you use AFP file server, run both cnid_metad and afpd. -CNID_METAD_RUN=yes -AFPD_RUN=yes - -#### maximum number of clients that can connect: -#AFPD_MAX_CLIENTS=20 - -#### UAMs (User Authentication Modules) -#### available options: uams_dhx.so, uams_dhx2.so, uams_guest.so, -#### uams_clrtxt.so(legacy), uams_randnum.so(legacy) -#AFPD_UAMLIST="-U uams_dhx.so,uams_dhx2.so" - -#### Set the id of the guest user when using uams_guest.so -#AFPD_GUEST=nobody - -#### config for cnid_metad. Default log config: -#CNID_CONFIG="-l log_note" - -######################################################################### -# AppleTalk specific configuration (legacy) -######################################################################### - -#### Set which legacy daemons to run. -#### If you need AppleTalk, run atalkd. -#### papd, timelord and a2boot are dependent upon atalkd. -#ATALKD_RUN=no -#PAPD_RUN=no -#TIMELORD_RUN=no -#A2BOOT_RUN=no - -#### Control whether the daemons are started in the background. -#### If it is dissatisfied that legacy atalkd starts slowly, set "yes". -#### In case using systemd/systemctl, this is not so significant. -#ATALK_BGROUND=no - -#### Set the AppleTalk Zone name. -#### NOTE: if your zone has spaces in it, you're better off specifying -#### it in atalkd.conf -#ATALK_ZONE=@zone diff --git a/man/man5/AppleVolumes.5 b/man/man5/AppleVolumes.5 deleted file mode 100644 index e12bc531..00000000 --- a/man/man5/AppleVolumes.5 +++ /dev/null @@ -1 +0,0 @@ -.so man5/AppleVolumes.default.5 diff --git a/man/man5/AppleVolumes.default.5.tmpl b/man/man5/AppleVolumes.default.5.tmpl deleted file mode 100644 index 6aabe036..00000000 --- a/man/man5/AppleVolumes.default.5.tmpl +++ /dev/null @@ -1,732 +0,0 @@ -'\" t -.\" Title: AppleVolumes.default -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 13 Oct 2011 -.\" Manual: Netatalk 2.2 -.\" Source: Netatalk 2.2 -.\" Language: English -.\" -.TH "APPLEVOLUMES\&.DEFAU" "5" "13 Oct 2011" "Netatalk 2.2" "Netatalk 2.2" -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -AppleVolumes.default, AppleVolumes.system, AppleVolumes \- Configuration file used by \fBafpd\fR(8) to determine the shares made available through AFP and specify file name extension mappings\&. -.SH "SYNOPSIS" -.HP \w'\fB:ETCDIR:/AppleVolumes\&.default\fR\fB\fR\fB:ETCDIR:/AppleVolumes\&.system\fR\fB\fR\fB~/AppleVolumes\fR\fB\fR\fB~/\&.AppleVolumes\fR\fB\fR\fB~/applevolumes\fR\fB\fR\fB~/\&.applevolumes\fR\fB\fR\ 'u -\fB:ETCDIR:/AppleVolumes\&.default\fR\fB\fR -.br -\fB:ETCDIR:/AppleVolumes\&.system\fR\fB\fR -.br -\fB~/AppleVolumes\fR\fB\fR -.br -\fB~/\&.AppleVolumes\fR\fB\fR -.br -\fB~/applevolumes\fR\fB\fR -.br -\fB~/\&.applevolumes\fR\fB\fR -.SH "DESCRIPTION" -.PP - -:ETCDIR:/AppleVolumes\&.system -and one of -:ETCDIR:/AppleVolumes\&.default, -~/AppleVolumes, -~/\&.AppleVolumes, -~/applevolumes, or -~/\&.applevolumes -are the configuration files used by -\fBafpd\fR -to determine what portions of the file system will be shared via Apple Filing Protocol, as well as their behaviour\&. -.PP -Any line not prefixed with # is interpreted\&. Newline escaping is supported\&. The configuration lines are composed like: -.PP -path -\fI[ volume name ] [ options ]\fR -.PP -\&.extension -\fI[ type [ creator ] ]\fR -.PP -The path name must be a fully qualified path name, or a path name using either the ~ shell shorthand or any of the substitution variables, which are listed below\&. -.PP -The volume name is the name that appears in the Chooser ot the "connect to server" dialog on Macintoshes to represent the appropriate share\&. If volumename is unspecified, the last component of pathname is used\&. No two volumes may have the same name\&. If there are spaces in the name, it should be in quotes (i\&.e\&. "File Share")\&. The volume name cannot contain the -\':\' -character\&. The volume name is mangled if it is very long\&. Mac codepage volume name is limited to 27 characters\&. UTF8\-MAC volume name is limited to \-volnamelen parameter in afpd\&.conf -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -.PP -Each volume has to be configured on a -\fBsingle\fR -line\&. Though newline escaping is supported\&. -.sp .5v -.RE -.PP -The leading\-dot lines specify file name extension mappings\&. The extension \'\&.\' sets the default creator and type for otherwise untyped Unix files\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -.PP -File name extension mapping is useful for Mac OS 9 and earlier\&. But it should not use for Mac OS X\&. -.sp .5v -.RE -.PP -It is possible to specify default options for all volumes with a -\fI:DEFAULT: \fRline preceeding these volume definitions: -.PP -\fBExample.\ \&:DEFAULT: configuration line\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -:DEFAULT: options:upriv,usedots dbpath:/var/dbd/AppleDB/$v dperm:0775 fperm:0664 -.fi -.if n \{\ -.RE -.\} -.PP -The possible options and their meanings are: -.PP -adouble:\fI[v1|v2|osx]\fR -.RS 4 -Specify the format of the metadata files, which are used for saving Mac resource fork as well\&. Earlier versions used AppleDouble V1, the new default format is V2\&. Starting with Netatalk 2\&.0, the scheme MacOS X 10\&.3\&.x uses, is also supported\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -\fBadouble:osx\fR -\fBcannot\fR -be treated normally any longer\&. Its only aim was to temporarely share eg\&. FAT32 formatted FireWire harddrives written on a Macintosh with afpd\&. Apple\'s metadata scheme lacks several essential features, so using it on the server\'s side will break both CNIDs and MacOS 9 compatibility\&. AppleDouble file of Mac OS X 10\&.6 is incompatible to V1 and V2\&. -.sp .5v -.RE -.RE -.PP -volsizelimit:\fIsize in MiB\fR -.RS 4 -Useful for TimeMachine: limits the reported volume size, thus preventing TM from using the whole real disk space for backup\&. Example: "volsizelimit:1000" would limit the reported disk space to 1 GB\&. -\fBIMPORTANT: \fR -This is an approximated calculation taking into accout the contents of TM sparsebundle images\&. Therefor you MUST NOT use this volume to store other content when using this option, because it would NOT be accounted\&. The calculation works by reading the band size from the Info\&.plist XML file of the sparsebundle, reading the bands/ directory counting the number of band files, and then multiplying one with the other\&. -.RE -.PP -allow:\fI[users/groups]\fR -.RS 4 -The allow option allows the users and groups that access a share to be specified\&. Users and groups are specified, delimited by commas\&. Groups are designated by a @ prefix\&. Example: allow:user1,user2,@group -.RE -.PP -deny:\fI[users/groups]\fR -.RS 4 -The deny option specifies users and groups who are not allowed access to the share\&. It follows the same format as the allow option\&. -.RE -.PP -allowed_hosts:\fI[IP host address/IP netmask bits[, \&.\&.\&. ]]\fR -.RS 4 -Only listed hosts and networks are allowed, all others are rejected\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&. -.sp -Example: allowed_hosts:10\&.1\&.0\&.0/16,10\&.2\&.1\&.100,2001:0db8:1234::/48 -.RE -.PP -denied_hosts:\fI[IP host address/IP netmask bits[, \&.\&.\&.]]\fR -.RS 4 -Listed hosts and nets are rejected, all others are allowed\&. -.sp -Example: denied_hosts: 192\&.168\&.100/24,10\&.1\&.1\&.1,2001:db8::1428:57ab -.RE -.PP -cnidscheme:\fI[backend]\fR -.RS 4 -set the CNID backend to be used for the volume, default is [:DEFAULT_CNID_SCHEME:] available schemes: [:COMPILED_BACKENDS:] -.RE -.PP -dbpath:\fI[path]\fR -.RS 4 -Sets the database information to be stored in path\&. You have to specifiy a writable location, even if the volume is read only\&. -.RE -.PP -cnidserver:\fI[fqdn|IP[:port]]\fR -.RS 4 -Query this servername or IP address (default:\fIlocalhost\fR) and port (default: -\fI4700\fR) for CNIDs\&. Only used with CNID backend "\fIdbd\fR"\&. This option here overrides any setting from -afpd\&.conf:\fBcnidserver\fR\&. -.RE -.PP -ea:\fI[none|auto|sys|ad]\fR -.RS 4 -Specify how Extended Attributes -are stored\&. -\fBauto\fR -is the default\&. -.PP -auto -.RS 4 -Try -\fBsys\fR -(by setting an EA on the shared directory itself), fallback to -\fBad\fR\&. Requires writeable volume for perfoming test\&. -\fBoptions:ro\fR -overwrites -\fBauto\fR -with -\fBnone\fR\&. Use explicit -\fBea:sys|ad\fR -for read\-only volumes where appropiate\&. -.RE -.PP -sys -.RS 4 -Use filesystem Extended Attributes\&. -.RE -.PP -ad -.RS 4 -Use files in -\fI\&.AppleDouble\fR -directories\&. -.RE -.PP -none -.RS 4 -No Extended Attributes support\&. -.RE -.RE -.PP -maccharset:\fI[charset]\fR -.RS 4 -specifies the mac client codepage for this Volume, e\&.g\&. "MAC_ROMAN", "MAC_CYRILLIC"\&. If not specified the setting from -afpd\&.conf -is inherited\&. This setting is only required if you need volumes, where the mac codepage differs from the one globally set in -afpd\&.conf\&. -.RE -.PP -options:\fI[option]\fR -.RS 4 -This allows multiple options to be specified in a comma delimited format\&. The available options are: -.PP -searchdb -.RS 4 -Use fast CNID database namesearch instead of slow recursive filesystem search\&. Relies on a consistent CNID database, ie Samba or local filesystem access lead to inaccurate or wrong results\&. Works only for "dbd" CNID db volumes\&. -.RE -.PP -tm -.RS 4 -Enable Time Machine suport for this volume\&. -.RE -.PP -invisibledots -.RS 4 -Use with -\fBusedots\fR: make dot files invisible\&. -.RE -.PP -nonetids -.RS 4 -Try to force ACL unawareness on the client\&. -.RE -.PP -limitsize -.RS 4 -Limit disk size reporting to 2GB\&. This can be used for older Macintoshes using newer Appleshare clients\&. -.RE -.PP -preexec_close -.RS 4 -a non\-zero return code from preexec close the volume being immediately, preventing clients to mount/see the volume in question\&. -.RE -.PP -ro -.RS 4 -Specifies the share as being read only for all users\&. The \&.AppleDB directory has to be writeable, you can use the -\fB\-dbpath\fR -option to relocate it\&. Overwrites -\fBea:auto\fR -with -\fBea:none\fR -.RE -.PP -root_preexec_close -.RS 4 -a non\-zero return code from root_preexec closes the volume immediately, preventing clients to mount/see the volume in question\&. -.RE -.PP -upriv -.RS 4 -use AFP3 unix privileges\&. This should be set for OS X clients\&. Starting with Netatalk 2\&.1 it\'s part of the default config :DEFAULT: line\&. See also: -\fBperm|fperm|dperm\fR\&. -.RE -.PP -usedots -.RS 4 -Don\'t do :hex translation for dot files\&. note: when this option gets set, certain file names become illegal\&. These are \&.Parent and anything that starts with \&.Apple\&. See also -\fBinvisibledots\fR\&. -.RE -.RE -.PP -password:\fI[password]\fR -.RS 4 -This option allows you to set a volume password, which can be a maximum of 8 characters long (using ASCII strongly recommended at the time of this writing)\&. -.RE -.PP -perm|fperm|dperm:\fI[mode]\fR -.RS 4 -Add(or) with the client requested permissions: -\fBperm\fR -affects files and directories, -\fBfperm\fR -is for files only, -\fBdperm\fR -is for directories only\&. Use with -\fBoptions:upriv\fR\&. -.PP -\fBExample.\ \&Volume for a collaborative workgroup\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -/path/to/volume "Workgroup" options:upriv dperm:0770 fperm:0660 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -umask:\fI[mode]\fR -.RS 4 -set perm mask\&. Use with -\fBoptions:upriv\fR\&. -.RE -.PP -preexec:\fI[command]\fR -.RS 4 -command to be run when the volume is mounted, ignored for user defined volumes -.RE -.PP -postexec:\fI[command]\fR -.RS 4 -command to be run when the volume is closed, ignored for user defined volumes -.RE -.PP -root_preexec:\fI[command]\fR -.RS 4 -command to be run as root when the volume is mounted, ignored for user defined volumes -.RE -.PP -root_postexec:\fI[command]\fR -.RS 4 -command to be run as root when the volume is closed, ignored for user defined volumes -.RE -.PP -rolist:[\fBusers/groups\fR] -.RS 4 -Allows certain users and groups to have read\-only access to a share\&. This follows the allow option format\&. -.RE -.PP -rwlist:\fI[users/groups]\fR -.RS 4 -Allows certain users and groups to have read/write access to a share\&. This follows the allow option format\&. -.RE -.PP -veto:\fI[vetoed names]\fR -.RS 4 -hide files and directories,where the path matches one of the \'/\' delimited vetoed names\&. The veto string must always be terminated with a \'/\', eg\&. "veto1/", "veto1/veto2/"\&. -.RE -.PP -volcharset:\fI[charset]\fR -.RS 4 -specifies the volume codepage, e\&.g\&. "UTF8", "UTF8\-MAC", "ISO\-8859\-15"\&. Defaults to "UTF8"\&. -.RE -.SH "VARIABLE SUBSTITUTIONS" -.PP -You can use variables in both volume path and volume name\&. -.sp -.RS 4 -.ie n \{\ -\h'-04' 1.\h'+01'\c -.\} -.el \{\ -.sp -1 -.IP " 1." 4.2 -.\} -if you specify an unknown variable, it will not get converted\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04' 2.\h'+01'\c -.\} -.el \{\ -.sp -1 -.IP " 2." 4.2 -.\} -if you specify a known variable, but that variable doesn\'t have a value, it will get ignored\&. -.RE -.PP -The variables which can be used for substitutions are: -.PP -$b -.RS 4 -basename -.RE -.PP -$c -.RS 4 -client\'s ip or appletalk address -.RE -.PP -$d -.RS 4 -volume pathname on server -.RE -.PP -$f -.RS 4 -full name (contents of the gecos field in the passwd file) -.RE -.PP -$g -.RS 4 -group name -.RE -.PP -$h -.RS 4 -hostname -.RE -.PP -$i -.RS 4 -client\'s ip, without port -.RE -.PP -$s -.RS 4 -server name (this can be the hostname) -.RE -.PP -$u -.RS 4 -user name (if guest, it is the user that guest is running as) -.RE -.PP -$v -.RS 4 -volume name (either ADEID_NAME or basename of path) -.RE -.PP -$z -.RS 4 -appletalk zone (may not exist) -.RE -.PP -$$ -.RS 4 -prints dollar sign ($) -.RE -.PP -\fBExample.\ \&Using variable substitution when defining volumes\fR -.PP -.if n \{\ -.RS 4 -.\} -.nf -/home/groups/$g "Groupdir for $g" -~ "$f is the best one" -.fi -.if n \{\ -.RE -.\} -.sp -We define "groupdirs" for each primary group and use a personalized server name for homedir shares\&. -.SH "CNID BACKENDS" -.PP -The AFP protocol mostly refers to files and directories by ID and not by name\&. Netatalk needs a way to store these ID\'s in a persistent way, to achieve this several different CNID backends are available\&. The CNID Databases are by default located in the -\&.AppleDB -folder in the volume root\&. -.PP -cdb -.RS 4 -"Concurrent database", backend is based on Sleepycat\'s Berkely DB\&. With this backend several -\fBafpd\fR -deamons access the CNID database directly\&. Berkeley DB locking is used to synchronize access, if more than one -\fBafpd\fR -process is active for a volume\&. The drawback is, that the crash of a single -\fBafpd\fR -process might corrupt the database\&. -.RE -.PP -dbd -.RS 4 -Access to the CNID database is restricted to the -\fBcnid_metad\fR -daemon process\&. -\fBafpd\fR -processes communicate with the daemon for database reads and updates\&. If built with Berkeley DB transactions the probability for database corruption is practically zero, but performance can be slower than with -\fBcdb\fR -.RE -.PP -last -.RS 4 -This backend is an exception, in terms of ID persistency\&. ID\'s are only valid for the current session\&. This is basically what -\fBafpd\fR -did in the 1\&.5 (and 1\&.6) versions\&. This backend is still available, as it is useful for e\&.g\&. sharing cdroms\&. -.sp -\fBWarning\fR: It is -\fINOT\fR -recommended to use this backend for volumes anymore, as -\fBafpd\fR -now relies heavily on a persistent ID database\&. Aliases will likely not work and filename mangling is not supported\&. -.RE -.PP -Even though -\fB\&./configure \-\-help\fR -might show that there are other CNID backends available, be warned those are likely broken or mainly used for testing\&. Don\'t use them unless you know what you\'re doing, they may be removed without further notice from future versions\&. -.SH "CHARSET OPTIONS" -.PP -With OS X Apple introduced the AFP3 protocol\&. One of the most important changes was that AFP3 uses unicode names encoded as UTF\-8 decomposed\&. Previous AFP/OS versions used codepages, like MacRoman, MacCentralEurope, etc\&. -.PP -\fBafpd\fR -needs a way to preserve extended macintosh characters, or characters illegal in unix filenames, when saving files on a unix filesystem\&. Earlier versions used the the so called CAP encoding\&. An extended character (>0x7F) would be converted to a :xx sequence, e\&.g\&. the Apple Logo (MacRoman: 0XF0) was saved as -:f0\&. Some special characters will be converted as to :xx notation as well\&. \'/\' will be encoded to -:2f, if -\fBusedots\fR -is not specified, a leading dot \'\&.\' will be encoded as -:2e\&. -.PP -This version now uses UTF\-8 as the default encoding for names\&. Special characters, like \'/\' and a leading \'\&.\' will still be CAP style encoded \&. -.PP -The -\fB\-volcharset\fR -option will allow you to select another volume encoding\&. E\&.g\&. for western users another useful setting could be \-volcharset ISO\-8859\-15\&. -\fBapfd\fR -will accept any -\fBiconv\fR(1) -provided charset\&. If a character cannot be converted from the mac codepage to the selected volcharset, afpd will save it as a CAP encoded character\&. For AFP3 clients, -\fBafpd\fR -will convert the UTF\-8 -character to -\fB\-maccharset\fR -first\&. If this conversion fails, you\'ll receive a \-50 error on the mac\&. -.PP -\fINote\fR: Whenever you can, please stick with the default UTF\-8 volume format\&. -.SH "COMPATIBILITY WITH EARLIER VERSIONS" -.PP -To use a volume created with an earlier -\fBafpd\fR -version, you\'ll have to specify the following options: -.PP -\fBExample.\ \&use a 1.x style volume\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -/path/to/volume "Volname" adouble:v1 volcharset:ASCII -.fi -.if n \{\ -.RE -.\} -.PP -In case you used an NLS you could try using a compatible iconv charset for -\fB\-volcharset\fR\&. -.PP -\fBExample.\ \&use a 1.x style volume, created with maccode.iso8859-1\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -/path/to/volume "Volname" adouble:v1 volcharset:ISO\-8859\-1 -.fi -.if n \{\ -.RE -.\} -.PP -You should consider converting old style volumes to the new UTF\-8/AD2 format\&. The safest way to do this, is to create a new volume with the default options and copy the files between this volumes with a mac\&. -.PP -\fINote\fR: Using above example options will allow you to downgrade to 1\&.x netatalk again\&. -.PP -\fINote\fR: Some 1\&.x NLS files used non standard mappings, e\&.g\&. -maccode\&.iso8859\-1\&.adapted\&. Three 1\&.x CAP double\-byte maccharsets are incompatible to netatalk 2\&.x; "MAC_CHINESE_TRAD", "MAC_JAPANESE" and "MAC_KOREAN"\&. These are not supported anymore\&. You\'ll have to copy the contents of those volumes files to a Mac and then back to the netatalk server, preferably to an UTF\-8 volume\&. -.SH "ADVANCED OPTIONS" -.PP -The following options should only be used after serious consideration\&. Be sure you fully understood the, sometimes complex, consequences, before using them\&. -.PP -casefold:\fB[option]\fR -.RS 4 -The casefold option handles, if the case of filenames should be changed\&. The available options are: -.sp -\fBtolower\fR -\- Lowercases names in both directions\&. -.sp -\fBtoupper\fR -\- Uppercases names in both directions\&. -.sp -\fBxlatelower\fR -\- Client sees lowercase, server sees uppercase\&. -.sp -\fBxlateupper\fR -\- Client sees uppercase, server sees lowercase\&. -.RE -.PP -options:[\fBoption\fR] -.RS 4 -This allows multiple options to be specified in a comma delimited format\&. The available options are: -.PP -caseinsensitive -.RS 4 -The underlying filesystem is case insensitive (only tested with JFS in OS2 mode)\&. -.RE -.PP -crlf -.RS 4 -Enables crlf translation for TEXT files, automatically converting macintosh line breaks into Unix ones\&. Use of this option might be dangerous since some older programs store binary data files as type "TEXT" when saving and switch the filetype in a second step\&. -\fBAfpd\fR -will potentially destroy such files when "erroneously" changing bytes in order to do line break translation\&. -.RE -.PP -dropbox -.RS 4 -Allows a volume to be declared as being a "dropbox\&." Note that netatalk must be compiled with dropkludge support for this to function\&. -\fIWarning\fR: This option is deprecated and might not work as expected\&. -.RE -.PP -dropkludge -.RS 4 -same as "dropbox"\&. -.RE -.PP -mswindows -.RS 4 -Forces filename restrictions imposed by MS WinXX\&. -\fIWarning\fR: This is -\fINOT\fR -recommened for volumes mainly used by Macs\&. Please make sure you fully understand this option before using it\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBWarning\fR -.ps -1 -.br -This option breaks direct saving to netatalk volumes from some applications, i\&.e\&. OfficeX\&. -.sp .5v -.RE -.RE -.PP -noadouble -.RS 4 -Forces -\fBafpd\fR -to not create \&.AppleDouble directories unless macintosh metadata needs to be written\&. This option is only useful if you want to share files mostly used NOT by macs, causing -\fBafpd\fR -to not automatically create \&.AppleDouble subdirs containing AD header files in every directory it enters (which will it do by default)\&. -.sp -In case, you save or change files from mac clients, AD metadata files have to be written even in case you set this option\&. So you can\'t avoid the creation of \&.AppleDouble directories and its contents when you give macs write access to a share and they make use of it\&. -.sp -Try to avoid -\fBnoadouble\fR -whenever possible\&. -.RE -.PP -nocnidcache -.RS 4 -If set -\fBafpd\fR -doesn\'t store the ID information in AppleDouble V2 header files\&. As these IDs are used for caching and as a database backup, this option normally shouldn\'t be set\&. -.RE -.PP -nodev -.RS 4 -always use 0 for device number, helps when the device number is not constant across a reboot, cluster, \&.\&.\&. -.RE -.PP -nofileid -.RS 4 -don\'t advertise createfileid, resolveid, deleteid calls\&. -.RE -.PP -nohex -.RS 4 -Disables :hex translations for anything except dot files\&. This option makes the -\'/\' character illegal\&. -.RE -.PP -nostat -.RS 4 -don\'t stat volume path when enumerating volumes list, useful for automounting or volumes created by a preexec script\&. -.RE -.PP -prodos -.RS 4 -Provides compatibility with Apple II clients\&. (legacy) -.RE -.RE -.SH "FILE NAME EXTENSION MAPPINGS" -.PP -\fBExample.\ \&Extension is jpg. Type is "JPEG". Creator is "ogle".\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\&.jpg "JPEG" "ogle" -.fi -.if n \{\ -.RE -.\} -.PP -\fBExample.\ \&Extension is lzh. Type is "LHA ". Creator is not defined.\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\&.lzh "LHA " -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.PP -\fBafpd.conf\fR(5), -\fBafpd\fR(8), -\fBcnid_metad\fR(8) diff --git a/man/man5/AppleVolumes.system.5 b/man/man5/AppleVolumes.system.5 deleted file mode 100644 index e12bc531..00000000 --- a/man/man5/AppleVolumes.system.5 +++ /dev/null @@ -1 +0,0 @@ -.so man5/AppleVolumes.default.5 diff --git a/man/man5/Makefile.am b/man/man5/Makefile.am index 2f7ec5b6..55d6b2aa 100644 --- a/man/man5/Makefile.am +++ b/man/man5/Makefile.am @@ -13,21 +13,9 @@ SUFFIXES = .tmpl . -e "s@:COMPILED_BACKENDS:@${compiled_backends}@g" \ <$< >$@ -GENERATED_MANS = AppleVolumes.default.5 \ - afpd.conf.5 \ - netatalk.conf.5 \ - afp_ldap.conf.5 \ - afp_signature.conf.5 \ - afp_voluuid.conf.5 - -TEMPLATE_FILES = AppleVolumes.default.5.tmpl \ - afpd.conf.5.tmpl \ - netatalk.conf.5.tmpl \ - afp_ldap.conf.5.tmpl \ - afp_signature.conf.5.tmpl \ - afp_voluuid.conf.5.tmpl - -NONGENERATED_MANS = AppleVolumes.5 AppleVolumes.system.5 +GENERATED_MANS = +TEMPLATE_FILES = +NONGENERATED_MANS = man_MANS = $(GENERATED_MANS) $(NONGENERATED_MANS) diff --git a/man/man5/afp_ldap.conf.5.tmpl b/man/man5/afp_ldap.conf.5.tmpl deleted file mode 100644 index 8ad13027..00000000 --- a/man/man5/afp_ldap.conf.5.tmpl +++ /dev/null @@ -1,164 +0,0 @@ -'\" t -.\" Title: afp_ldap.conf -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 30 Mar 2011 -.\" Manual: Netatalk 2.2 -.\" Source: Netatalk 2.2 -.\" Language: English -.\" -.TH "AFP_LDAP\&.CONF" "5" "30 Mar 2011" "Netatalk 2.2" "Netatalk 2.2" -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -afp_ldap.conf \- Configuration file used by afpd(8) to configure a LDAP connection to an LDAP server\&. That is needed for ACL support in order to be able to query LDAP for UUIDs\&. -.SH "DESCRIPTION" -.PP -:ETCDIR:/afp_ldap\&.conf -is the configuration file used by -\fBafpd\fR -to set up an LDAP connection to an LDAP server\&. -.PP -Any line not prefixed with # is interpreted\&. -.PP -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -.PP -You can use -\fBafpldaptest\fR(1) -to syntactically check your config -.sp .5v -.RE -The required parameters and their meanings are: -.SH "PARAMETER" -.PP -ldap_server -.RS 4 -Name or IP address of your LDAP Server -.sp -.RE -.PP -ldap_auth_method -.RS 4 -Authentication method: -\fBnone | simple | sasl\fR -.PP -none -.RS 4 -anonymous LDAP bind -.RE -.PP -simple -.RS 4 -simple LDAP bind -.RE -.PP -sasl -.RS 4 -SASL\&. Not yet supported ! -.RE -.RE -.PP -ldap_auth_dn -.RS 4 -Distinguished Name of the user for simple bind\&. -.sp -.RE -.PP -ldap_auth_pw -.RS 4 -Distinguished Name of the user for simple bind\&. -.sp -.RE -.PP -ldap_userbase -.RS 4 -DN of the user container in LDAP\&. -.sp -.RE -.PP -ldap_userscope -.RS 4 -Search scope for user search: -\fBbase | one | sub\fR -.sp -.RE -.PP -ldap_groupbase -.RS 4 -DN of the group container in LDAP\&. -.sp -.RE -.PP -ldap_groupscope -.RS 4 -Search scope for user search: -\fBbase | one |\ \&sub\fR -.sp -.RE -.PP -ldap_uuuid_attr -.RS 4 -Name of the LDAP attribute with the UUIDs\&. -.sp -Note: this is used both for users and groups\&. -.sp -.RE -.PP -ldap_name_attr -.RS 4 -Name of the LDAP attribute with the users short name\&. -.sp -.RE -.PP -ldap_group_attr -.RS 4 -Name of the LDAP attribute with the groups short name\&. -.sp -.RE -.SH "EXAMPLES" -.PP -\fBExample.\ \&afp_ldap.conf setup with simple bind\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -ldap_server = localhost -ldap_auth_method = simple -ldap_auth_dn = cn=admin,dc=domain,dc=org -ldap_auth_pw = notthisone -ldap_userbase = ou=users,dc=domain,dc=org -ldap_userscope = one -ldap_groupbase = ou=groups,dc=domain,dc=org -ldap_groupscope = one -ldap_uuid_attr = some_attribute -ldap_name_attr = cn -ldap_group_attr = cn -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.PP -\fBafpd\fR(8), -\fBAppleVolumes.default\fR(5), -\fBafpldaptest\fR(1) diff --git a/man/man5/afp_signature.conf.5.tmpl b/man/man5/afp_signature.conf.5.tmpl deleted file mode 100644 index 592b8fbb..00000000 --- a/man/man5/afp_signature.conf.5.tmpl +++ /dev/null @@ -1,79 +0,0 @@ -'\" t -.\" Title: afp_signature.conf -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 08 Mar 2011 -.\" Manual: Netatalk 2.2 -.\" Source: Netatalk 2.2 -.\" Language: English -.\" -.TH "AFP_SIGNATURE\&.CONF" "5" "08 Mar 2011" "Netatalk 2.2" "Netatalk 2.2" -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -afp_signature.conf \- Configuration file used by afpd(8) to specify server signature -.SH "DESCRIPTION" -.PP -:ETCDIR:/afp_signature\&.conf -is the configuration file used by -\fBafpd\fR -to specify server signature automagically\&. The configuration lines are composed like: -.PP -\fI"server name"\fR -\fIhexa\-string\fR -.PP -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\&. -.PP -The leading spaces and tabs are ignored\&. Blank lines are ignored\&. The lines prefixed with # are ignored\&. The illegal lines are ignored\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -.PP -Server Signature is unique 16\-bytes identifier used to prevent logging on to the same server twice\&. -.PP -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\&. -.PP -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\&. -.PP -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 user:xxxx" in afpd\&.conf\&. In this case, afp_signature\&.conf is not used\&. -.sp .5v -.RE -.PP -.SH "EXAMPLES" -.PP -\fBExample.\ \&afp_signature.conf three servers on one netatalk\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -# This is a comment\&. -"Guest Server" 251D25569CB29AFDF296C6B5B3A385B7 -"User Server" 26B5D785046C019F55718F76B1C13BFB -special 74A0BB94EC8C13988B2E75042347E528 -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.PP -\fBafpd\fR(8), -\fBafpd.conf\fR(5), -\fBasip-status.pl\fR(1) diff --git a/man/man5/afp_voluuid.conf.5.tmpl b/man/man5/afp_voluuid.conf.5.tmpl deleted file mode 100644 index c36a1124..00000000 --- a/man/man5/afp_voluuid.conf.5.tmpl +++ /dev/null @@ -1,77 +0,0 @@ -'\" t -.\" Title: afp_voluuid.conf -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 8 March 2011 -.\" Manual: Netatalk 2.2 -.\" Source: Netatalk 2.2 -.\" Language: English -.\" -.TH "AFP_VOLUUID\&.CONF" "5" "8 March 2011" "Netatalk 2.2" "Netatalk 2.2" -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -afp_voluuid.conf \- Configuration file used by afpd(8) to specify UUID for Time Machine volume -.SH "DESCRIPTION" -.PP -:ETCDIR:/afp_voluuid\&.conf -is the configuration file used by -\fBafpd\fR -to specify UUID of Time Machine volume automagically\&. The configuration lines are composed like: -.PP -\fI"volume name"\fR -\fIuuid\-string\fR -.PP -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\&. -.PP -The leading spaces and tabs are ignored\&. Blank lines are ignored\&. The lines prefixed with # are ignored\&. The illegal lines are ignored\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -.PP -This UUID is advertised by Zeroconf in order to provide robust disambiguation of Time Machine volume\&. -.PP -The afpd generates the UUID from random numbers and saves it into afp_voluuid\&.conf, only when setting "tm" option in AppleVolumes file\&. -.PP -This file should not be thoughtlessly edited and be copied onto another server\&. -.sp .5v -.RE -.PP -.SH "EXAMPLES" -.PP -\fBExample.\ \&afp_voluuid.conf three TM volumes on one netatalk\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -# This is a comment\&. -"Backup for John Smith" 1573974F\-0ABD\-69CC\-C40A\-8519B681A0E1 -"bob" 39A487F4\-55AA\-8240\-E584\-69AA01800FE9 -mary 6331E2D1\-446C\-B68C\-3066\-D685AADBE911 -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.PP -\fBafpd\fR(8), -\fBAppleVolumes.default\fR(5), -\fBavahi-daemon\fR(8) diff --git a/man/man5/afpd.conf.5.tmpl b/man/man5/afpd.conf.5.tmpl deleted file mode 100644 index c6d02887..00000000 --- a/man/man5/afpd.conf.5.tmpl +++ /dev/null @@ -1,676 +0,0 @@ -'\" t -.\" Title: afpd.conf -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 15 Aug 2011 -.\" Manual: Netatalk 2.2 -.\" Source: Netatalk 2.2 -.\" Language: English -.\" -.TH "AFPD\&.CONF" "5" "15 Aug 2011" "Netatalk 2.2" "Netatalk 2.2" -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -afpd.conf \- Configuration file used by afpd(8) to determine the setup of its file sharing services -.SH "DESCRIPTION" -.PP -:ETCDIR:/afpd\&.conf -is the configuration file used by -\fBafpd\fR -to determine the behavior and configuration of the different virtual file servers that it provides\&. -.PP -Any line not prefixed with # is interpreted\&. The configuration lines are composed like: server name [ options ] If a -\fB\-\fR -is used instead of a server name, the default server is specified\&. Server names must be quoted if they contain spaces\&. They must not contain ":" or "@"\&. The path name must be a fully qualified path name, or a path name using either the ~ shell shorthand or any of the substitution variables, which are listed below\&. -.PP -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -.PP -Each server has to be configured on a -\fBsingle\fR -line\&. Though, using "\e" character, newline escaping is supported\&. -.sp .5v -.RE -The possible options and their meanings are: -.SH "APPLEVOLUMES FILES" -.PP -\-defaultvol \fI[path]\fR -.RS 4 -Specifies path to AppleVolumes\&.default file (default is -:ETCDIR:/AppleVolumes\&.default)\&. -.RE -.PP -\-systemvol \fI[path]\fR -.RS 4 -Specifies path to AppleVolumes\&.system file (default is -:ETCDIR:/AppleVolumes\&.system)\&. -.RE -.PP -\-[no]uservol -.RS 4 -Enables or disables reading of the users\' individual volumes file entirely\&. -.RE -.PP -\-[no]uservolfirst -.RS 4 -Enables or disables reading of the users\' individual volumes file before processing the global -AppleVolumes\&.default -file\&. -.RE -.SH "AUTHENTICATION METHODS" -.PP -\-uamlist \fI[uams list]\fR -.RS 4 -Comma separated list of UAMs\&. (The default is uams_dhx\&.so,uams_dhx2\&.so)\&. -.sp -The most commonly used UAMs are: -.PP -uams_guest\&.so -.RS 4 -allows guest logins -.RE -.PP -uams_clrtxt\&.so -.RS 4 -(uams_pam\&.so or uams_passwd\&.so) Allow logins with passwords transmitted in the clear\&. (legacy) -.RE -.PP -uams_randum\&.so -.RS 4 -allows Random Number and Two\-Way Random Number Exchange for authentication (requires a separate file containing the passwords, either :ETCDIR:/afppasswd file or the one specified via -\fB\-passwdfile\fR\&. See -\fBafppasswd\fR(1) -for details\&. (legacy) -.RE -.PP -uams_dhx\&.so -.RS 4 -(uams_dhx_pam\&.so or uams_dhx_passwd\&.so) Allow Diffie\-Hellman eXchange (DHX) for authentication\&. -.RE -.PP -uams_dhx2\&.so -.RS 4 -(uams_dhx2_pam\&.so or uams_dhx2_passwd\&.so) Allow Diffie\-Hellman eXchange 2 (DHX2) for authentication\&. -.RE -.PP -uam_gss\&.so -.RS 4 -Allow Kerberos V for authentication (optional) -.RE -.RE -.PP -\-uampath \fI[path]\fR -.RS 4 -Sets the default path for UAMs for this server (default is :ETCDIR:/uams)\&. -.RE -.PP -\-k5keytab \fI[path]\fR, \-k5service \fI[service]\fR, \-k5realm \fI[realm]\fR -.RS 4 -These are required if the server supports the Kerberos 5 authentication UAM\&. -.RE -.PP -\-ntdomain, \-ntseparator -.RS 4 -Use for eg\&. winbind authentication, prepends both strings before the username from login and then tries to authenticate with the result through the availabel and active UAM authentication modules\&. -.RE -.PP -\-adminauthuser -.RS 4 -Specifying eg -\fB\-adminauthuser root\fR -whenever a normal user login fails, afpd will try to authenticate as the specified -\fBadminauthuser\fR\&. If this succeeds, a normal session is created for the original connecting user\&. Said differently: if you know the password of -\fBadminauthuser\fR, you can authenticate as any other user\&. -.RE -.SH "CODEPAGE OPTIONS" -.PP -With OS X Apple introduced the AFP3 protocol\&. One of the big changes was, that AFP3 uses Unicode names encoded as Decomposed UTF\-8 (UTF8\-MAC)\&. Previous AFP/OS versions used codepages like MacRoman, MacCentralEurope, etc\&. -.PP -To be able to serve AFP3 and older clients at the same time, -\fBafpd\fR -needs to be able to convert between UTF\-8 and Mac codepages\&. Even OS X clients partly still rely on codepages\&. As there\'s no way, -\fBafpd\fR -can detect the codepage a pre AFP3 client uses, you have to specify it using the -\fB\-maccodepage\fR -option\&. The default is MacRoman, which should be fine for most western users\&. -.PP -As -\fBafpd\fR -needs to interact with unix operating system as well, it need\'s to be able to convert from UTF8\-MAC/MacCodepage to the unix codepage\&. By default -\fBafpd\fR -uses the systems LOCALE, or ASCII if your system doesn\'t support locales\&. You can set the unix codepage using the -\fB\-unixcodepage\fR -option\&. If you\'re using extended characters in the configuration files for -\fBafpd\fR, make sure your terminal matches the -\fB\-unixcodepage\fR\&. -.PP -\-unixcodepage [\fICODEPAGE\fR] -.RS 4 -Specifies the servers unix codepage, e\&.g\&. "ISO\-8859\-15" or "UTF8"\&. This is used to convert strings to/from the systems locale, e\&.g\&. for authenthication, server messages and volume names\&. Defaults to LOCALE if your system supports it, otherwise ASCII will be used\&. -.RE -.PP -\-maccodepage [\fICODEPAGE\fR] -.RS 4 -Specifies the mac clients codepage, e\&.g\&. "MAC_ROMAN"\&. This is used to convert strings and filenames to the clients codepage for OS9 and Classic, i\&.e\&. for authentication and AFP messages (SIGUSR2 messaging)\&. This will also be the default for the volumes maccharset\&. Defaults to MAC_ROMAN\&. -.RE -.SH "PASSWORD OPTIONS" -.PP -\-loginmaxfail [\fInumber\fR] -.RS 4 -Sets the maximum number of failed logins, if supported by the UAM (currently none) -.RE -.PP -\-passwdfile [\fIpath\fR] -.RS 4 -Sets the path to the Randnum UAM passwd file for this server (default is :ETCDIR:/afppasswd)\&. -.RE -.PP -\-passwdminlen [\fInumber\fR] -.RS 4 -Sets the minimum password length, if supported by the UAM -.RE -.PP -\-[no]savepassword -.RS 4 -Enables or disables the ability of clients to save passwords locally -.RE -.PP -\-[no]setpassword -.RS 4 -Enables or disables the ability of clients to change their passwords via chooser or the "connect to server" dialog -.RE -.SH "TRANSPORT PROTOCOLS" -.PP -\-[no]ddp -.RS 4 -Enables or disables AFP\-over\-Appletalk\&. If -\fB\-proxy\fR -is specified, you must instead use -\fB\-uamlist ""\fR -to prevent DDP connections from working\&. (default is \-noddp) -.RE -.PP -\-[no]tcp -.RS 4 -Enables or disables AFP\-over\-TCP (default is \-tcp) -.RE -.PP -\-transall -.RS 4 -Make both available -.RE -.SH "TRANSPORT OPTIONS" -.PP -\-advertise_ssh -.RS 4 -Allows Mac OS X clients (10\&.3\&.3\-10\&.4) to automagically establish a tunneled AFP connection through SSH\&. If this option is set, the server\'s answers to client\'s FPGetSrvrInfo requests contain an additional entry\&. It depends on both client\'s settings and a correctly configured and running -\fBsshd\fR(8) -on the server to let things work\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -Setting this option is not recommended since globally encrypting AFP connections via SSH will increase the server\'s load significantly\&. On the other hand, Apple\'s client side implementation of this feature in MacOS X versions prior to 10\&.3\&.4 contained a security flaw\&. -.sp .5v -.RE -.RE -.PP -\-ddpaddr \fI[ddp address]\fR -.RS 4 -Specifies the DDP address of the server\&. The default is to auto\-assign an address (0\&.0)\&. This is only useful if you are running AppleTalk on more than one interface\&. -.RE -.PP -\-fqdn \fI[name:port]\fR -.RS 4 -Specifies a fully\-qualified domain name, with an optional port\&. This is discarded if the server cannot resolve it\&. This option is not honored by AppleShare clients <= 3\&.8\&.3\&. This option is disabled by default\&. Use with caution as this will involve a second name resolution step on the client side\&. Also note that afpd will advertise this name:port combination but not automatically listen to it\&. -.RE -.PP -\-hostname\fI [name]\fR -.RS 4 -Use this instead of the result from calling hostname for dertermening which IP address to advertise, therfore the hostname is resolved to an IP which is the advertised\&. This is NOT used for listening and it is also overwritten by -\fB\-ipaddr\fR\&. -.RE -.PP -\-ipaddr \fI[ip address]\fR -.RS 4 -Specifies the IP address that the server should advertise -\fBand\fR -listens to\&. The default is advertise the first IP address of the system, but to listen for any incoming request\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&. This option also allows to use one machine to advertise the AFP\-over\-TCP/IP settings of another machine via NBP -when used together with the -\fB\-proxy\fR -option\&. -.PP -\fBExample.\ \&afpd.conf onfiguration line\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf - fluxxus \-hostname afp\&.example\&.org \-ipaddr 192\&.168\&.0\&.1 \-fqdn www\&.example\&.com - -.fi -.if n \{\ -.RE -.\} -.sp - -\fBResult\fR -.sp -(UTF8) Server name: fluxxus, Listening and advertised network address: 192\&.168\&.0\&.1, Advertised network address: www\&.example\&.com, hostname is not used\&. -.RE -.PP -\-port \fI[port number]\fR -.RS 4 -Allows a different TCP port to be used for AFP\-over\-TCP\&. The default is 548\&. -.RE -.PP -\-proxy -.RS 4 -Runs an AppleTalk proxy server for the specified AFP\-over\-TCP server\&. If the address and port aren\'t given, then the first IP address of the system and port 548 will be used\&. If you don\'t want the proxy server to act as a DDP -server as well, set -\fB\-uamlist ""\fR\&. -.RE -.PP -\-server_quantum \fI[number]\fR -.RS 4 -This specifies the DSI server quantum\&. The default value is 303840\&. The maximum value is 0xFFFFFFFFF, the minimum is 32000\&. If you specify a value that is out of range, the default value will be set\&. Do not change this value unless you\'re absolutely sure, what you\'re doing -.RE -.PP -\-dsireadbuf \fI[number]\fR -.RS 4 -Scale factor that determines the size of the DSI/TCP readahead buffer, default is 12\&. This is multiplies with the DSI server quantum (default ~300k) to give the size of the buffer\&. Increasing this value might increase throughput in fast local networks for volume to volume copies\&. -\fINote\fR: This buffer is allocated per afpd child process, so specifying large values will eat up large amount of memory (buffer size * number of clients)\&. -.RE -.PP -\-tcprcvbuf \fI[number]\fR -.RS 4 -Try to set TCP receive buffer using setsockpt()\&. Often OSes impose restrictions on the applications ability to set this value\&. -.RE -.PP -\-tcpsndbuf \fI[number]\fR -.RS 4 -Try to set TCP send buffer using setsockpt()\&. Often OSes impose restrictions on the applications ability to set this value\&. -.RE -.PP -\-nozeroconf -.RS 4 -Disable automatic Zeroconf -service registration if support was compiled in\&. -.RE -.PP -\-slp -.RS 4 -Register this server using the Service Location Protocol (if SLP -support was compiled in)\&. -.RE -.SH "MISCELLANEOUS OPTIONS" -.PP -\-admingroup \fI[group]\fR -.RS 4 -Allows users of a certain group to be seen as the superuser when they log in\&. This option is disabled by default\&. -.RE -.PP -\-authprintdir \fI[path]\fR -.RS 4 -Specifies the path to be used (per server) to store the files required to do CAP\-style print authentication which papd will examine to determine if a print job should be allowed\&. These files are created at login and if they are to be properly removed, this directory probably needs to be umode 1777\&. -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -\fB\-authprintdir\fR -will only work for clients connecting via DDP\&. Almost all modern Clients will use TCP\&. -.sp .5v -.RE -.RE -.PP -\-client_polling -.RS 4 -With this switch enabled, afpd won\'t advertise that it is capable of server notifications, so that connected clients poll the server every 10 seconds to detect changes in opened server windows\&. -\fINote\fR: Depending on the number of simultaneously connected clients and the network\'s speed, this can lead to a significant higher load on your network! -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -Do not use this option any longer as Netatalk 2\&.x correctly supports server notifications, allowing connected clients to update folder listings in case another client changed the contents\&. -.sp .5v -.RE -.RE -.PP -\-closevol -.RS 4 -Immediately unmount volumes removed from AppleVolumes files on SIGHUP sent to the afp master process\&. -.RE -.PP -\-cnidserver \fI[ipaddress:port]\fR -.RS 4 -Specifies the IP address and port of a cnid_metad server, required for CNID dbd backend\&. Defaults to localhost:4700\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&.\- -.RE -.PP -\-dircachesize\fI entries\fR -.RS 4 -Maximum possible entries in the directory cache\&. The cache stores directories and files\&. It is used to cache the full path to directories and CNIDs which considerably speeds up directory enumeration\&. -.sp -Default size is 8192, maximum size is 131072\&. Given value is rounded up to nearest power of 2\&. Each entry takes about 100 bytes, which is not much, but remember that every afpd child process for every connected user has its cache\&. -.RE -.PP -\-fcelistener \fIhost[:port]\fR -.RS 4 -Enables sending FCE events to the specified -\fIhost\fR, default -\fIport\fR -is 12250 if not specified\&. Specifying mutliple listeners is done by having this option once for each of them\&. -.RE -.PP -\-fceevents \fIfmod,fdel,ddel,fcre,dcre,tmsz\fR -.RS 4 -Speficies which FCE events are active, default is -\fIfmod,fdel,ddel,fcre,dcre\fR\&. -.RE -.PP -\-fcecoalesce \fIall|delete|create\fR -.RS 4 -Coalesce FCE events\&. -.RE -.PP -\-fceholdfmod \fIseconds\fR -.RS 4 -This determines the time delay in seconds which is always waited if another file modification for the same file is done by a client before sending an FCE file modification event (fmod)\&. For example saving a file in Photoshop would generate multiple events by itself because the application is opening, modifying and closing a file mutliple times for every "save"\&. Defautl: 60 seconds\&. -.RE -.PP -\-guestname \fI[name]\fR -.RS 4 -Specifies the user that guests should use (default is "nobody")\&. The name should be quoted\&. -.RE -.PP -\-[no]icon -.RS 4 -[Don\'t] Use the platform\-specific icon\&. Recent Mac OS don\'t display it any longer\&. -.RE -.PP -\-keepsessions -.RS 4 -Enable "Continuous AFP Service"\&. This means the ability to stop the master afpd process with a SIGQUIT signal, possibly install an afpd update and start the afpd process\&. Existing AFP sessions afpd processes will remain unaffected\&. Technically they will be notified of the master afpd shutdown, sleep 15\-20 seconds and then try to reconnect their IPC channel to the master afpd process\&. If this reconnect fails, the sessions are in an undefined state\&. Therefor it\'s absolutely critical to restart the master process in time! -.RE -.PP -\-loginmesg \fI[message]\fR -.RS 4 -Sets a message to be displayed when clients logon to the server\&. The message should be in -\fBunixcodepage\fR -and should be quoted\&. Extended characters are allowed\&. -.RE -.PP -\-mimicmodel \fImodel\fR -.RS 4 -Specifies the icon model that appears on clients\&. Defaults to off\&. Examples: RackMac (same as Xserve), PowerBook, PowerMac, Macmini, iMac, MacBook, MacBookPro, MacBookAir, MacPro, AppleTV1,1, AirPort\&. -.RE -.PP -\-noacl2maccess -.RS 4 -Don\'t map filesystem ACLs to effective permissions\&. -.RE -.PP -\-nodebug -.RS 4 -Disables debugging\&. -.RE -.PP -\-sleep \fI[number]\fR -.RS 4 -AFP 3\&.x waits -\fInumber\fR -hours before disconnecting clients in sleep mode\&. Default is 10 hours\&. -.RE -.PP -\-signature { user: | auto } -.RS 4 -Specify a server signature\&. This option is useful while running multiple independent instances of afpd on one machine (eg\&. in clustered environments, to provide fault isolation etc\&.)\&. Default is "auto"\&. "auto" signature type allows afpd generating signature and saving it to -:ETCDIR:/afp_signature\&.conf -automatically (based on random number)\&. "host" signature type switches back to "auto" because it is obsoleted\&. "user" signature type allows administrator to set up a signature string manually\&. The maximum length is 16 characters\&. -.PP -\fBExample.\ \&Three server definitions using 2 different server signatures\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -first \-signature user:USERS -second \-signature user:USERS -third \-signature user:ADMINS -.fi -.if n \{\ -.RE -.\} - - -First two servers will appear as one logical AFP service to the clients \- if user logs in to first one and then connects to second one, session will be automatically redirected to the first one\&. But if client connects to first and then to third, will be asked for password twice and will see resources of both servers\&. Traditional method of signature generation causes two independent afpd instances to have the same signature and thus cause clients to be redirected automatically to server (s)he logged in first\&. -.RE -.PP -\-volnamelen \fI[number] \fR -.RS 4 -Max length of UTF8\-MAC volume name for Mac OS X\&. Note that Hangul is especially sensitive to this\&. -.sp -.if n \{\ -.RS 4 -.\} -.nf -73: limit of Mac OS X 10\&.1 -80: limit for Mac OS X 10\&.4/10\&.5 (default) -255: limit of spec -.fi -.if n \{\ -.RE -.\} -.sp -Mac OS 9 and earlier are not influenced by this, because Maccharset volume name is always limitted to 27 bytes\&. -.RE -.SH "LOGGING OPTIONS" -.PP -\-setuplog "\fI []\fR" -.RS 4 -Specify that any message of a loglevel up to the given -\fBloglevel\fR -should be logged to the given file\&. If the filename is ommited the loglevel applies to messages passed to syslog\&. -.sp -By default (no explicit -\fB\-setuplog\fR -and no buildtime configure flag -\fB\-\-with\-logfile\fR) afpd logs to syslog with a default logging setup equivalent to -\fB"\-setuplog default log_info\fR"\&. -.sp -If build with -\fB\-\-with\-logfile\fR -(default logfile -\fI/var/log/netatalk\&.log\fR) or -\fB\-\-with\-logfile=somefile\fR -afpd defaults to a setup that is equivalent to "\fB\-setuplog default log_info [\fR\fB\fInetatalk\&.log|somefile]\fR\fR"\&. -.sp -logtypes: Default, AFPDaemon, Logger, UAMSDaemon -.sp -loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE, LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBNote\fR -.ps -1 -.br -The config is case\-ignoring -.sp .5v -.RE -.PP -\fBExample.\ \&Useful default config\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-setuplog "default log_info /var/log/afpd\&.log" -.fi -.if n \{\ -.RE -.\} -.PP -\fBExample.\ \&Debugging config\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-setuplog "default log_maxdebug /var/log/afpd\&.log" -.fi -.if n \{\ -.RE -.\} -.PP -\fBExample.\ \&afpd logging to different files\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-setuplog "default log_info /var/log/afpd\&.log" \e -\-setuplog "UAMSDaemon log_maxdebug /var/log/uams\&.log" -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-unsetuplog "\fI []\fR" -.RS 4 -Note that for -\fBunsetuplog\fR -specifying any string as filename is sufficient for the config parser to distinguish between requests to disable syslog logging or file\-logging\&. -.PP -\fBExample.\ \&Disable afpd logging set at build-time from configure\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-unsetuplog "default \-" -.fi -.if n \{\ -.RE -.\} -.RE -.SH "DEBUG OPTIONS" -.PP -These options are useful for debugging only\&. -.PP -\-tickleval \fI[number]\fR -.RS 4 -Sets the tickle timeout interval (in seconds)\&. Defaults to 30\&. -.RE -.PP -\-timeout \fI[number]\fR -.RS 4 -Specify the number of tickles to send before timing out a connection\&. The default is 4, therefore a connection will timeout after 2 minutes\&. -.RE -.SH "EXAMPLES" -.PP -\fBExample.\ \&afpd.conf default configuration\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-tcp \-noddp \-uamlist uams_dhx\&.so,uams_dhx2\&.so \-nosavepassword -.fi -.if n \{\ -.RE -.\} -.PP -\fBExample.\ \&afpd.conf MacCyrillic setup / UTF8 unix locale\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-maccodepage mac_cyrillic \-unixcodepage utf8 -.fi -.if n \{\ -.RE -.\} -.PP -\fBExample.\ \&afpd.conf setup for Kerberos V auth with newline escaping\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -\- \-uamlist uams_dhx\&.so,uams_dhx2\&.so,uams_guest\&.so,uams_gss\&.so \e -\-k5service afpserver \-k5keytab /path/to/afpserver\&.keytab \e -\-k5realm YOUR\&.REALM \-fqdn your\&.fqdn\&.namel:548 -.fi -.if n \{\ -.RE -.\} -.PP -\fBExample.\ \&afpd.conf letting afpd appear as three servers on the net\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -"Guest Server" \-uamlist uams_guest\&.so \-loginmesg "Welcome guest!" -"User Server" \-uamlist uams_dhx2\&.so \-port 12000 -"special" \-ddp \-notcp \-defaultvol \-systemvol -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.PP -\fBafpd\fR(8), -\fBafppasswd\fR(1), -\fBAppleVolumes.default\fR(5), -\fBafp_signature.conf\fR(5), -\fBcnid_metad\fR(8) diff --git a/man/man5/netatalk.conf.5.tmpl b/man/man5/netatalk.conf.5.tmpl deleted file mode 100644 index 6c9b4b74..00000000 --- a/man/man5/netatalk.conf.5.tmpl +++ /dev/null @@ -1,122 +0,0 @@ -'\" t -.\" Title: netatalk.conf -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 30 Mar 2011 -.\" Manual: Netatalk 2.2 -.\" Source: Netatalk 2.2 -.\" Language: English -.\" -.TH "NETATALK\&.CONF" "5" "30 Mar 2011" "Netatalk 2.2" "Netatalk 2.2" -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -netatalk.conf \- Configuration file used by Netatalk to determine its general configuration -.SH "SYNOPSIS" -.HP \w'\fB:ETCDIR:/netatalk\&.conf\fR\fB\fR\fB:DESTDIR:/etc/default/netatalk\fR\fB\fR\ 'u -\fB:ETCDIR:/netatalk\&.conf\fR\fB\fR -.br -\fB:DESTDIR:/etc/default/netatalk\fR\fB\fR -.SH "DESCRIPTION" -.PP -\fB:ETCDIR:/netatalk\&.conf\fR -is the configuration file used by afpd to determine what portions of the file system will be shared via AFP, as well as their behaviors\&. -.PP -If netatalk has been configured with \-\-enable\-debian, it is not -\fB:ETCDIR:/netatalk\&.conf\fR -but -\fB:DESTDIR:/etc/default/netatalk\fR\&. -.PP -Any line not prefixed with -\fB#\fR -is interpreted\&. The configuration lines are composed like: -.PP -\fIoption\fR -\fB=\fR -\fIvalue\fR -.PP -The possible options and their meanings are: -.PP -\fBAFPD_GUEST\fR -.RS 4 -Sets the id of the guest user to a local user on the system\&. -.RE -.PP -\fBAFPD_MAX_CLIENTS\fR -.RS 4 -Sets the maximum number of clients that can simultaneously connect to the server\&. -.RE -.PP -\fBAFPD_RUN\fR -.RS 4 -Enables the afpd daemon if set to "yes"\&. This should be enabled if you are planning on using netatalk as a file server\&. -.RE -.PP -\fBAFPD_UAM_LIST\fR -.RS 4 -Sets the default UAMs for afpd (and papd, if printer authentication is compiled in) to use\&. -.sp -\fIExample:\fR -\fBAFPD_UAMLIST\fR=\fB"\-U uams_guest\&.so,uams_randnum\&.so"\fR -.RE -.PP -\fBCNID_METAD_RUN\fR -.RS 4 -Enables the cnid_metad daemon if set to "yes"\&. This should be enabled if you are going to use the dbd CNID backend\&. -.RE -.PP -\fBCNID_CONFIG\fR -.RS 4 -Configuration options for cnid_metad\&. See: -\fBcnid_metad\fR(8) -.RE -.PP -\fBATALK_BGROUND\fR -.RS 4 -"yes" will set netatalk to initialize in the background, and "no" will cause normal initialization\&. -.RE -.PP -\fBATALK_NAME\fR -.RS 4 -Sets the machines\' Appletalk name\&. -.RE -.PP -\fBATALK_ZONE\fR -.RS 4 -Sets the machines\' Appletalk zone\&. -.RE -.PP -\fBATALKD_RUN\fR -.RS 4 -Enables the atalkd daemon if set to "yes"\&. This should be enabled if you are planning on providing Appletalk services\&. -.RE -.PP -\fBPAPD_RUN\fR -.RS 4 -Enables the papd daemon if set to "yes"\&. This should be enabled if you are planning on using netatalk as a print server\&. -.RE -.PP -\fBATALK_MAC_CHARSET\fR -.RS 4 -Set the Mac client codepage, used by atalkd and papd to convert extended characters from the Unix to the Mac codepage\&. -.RE -.PP -\fBATALK_UNIX_CHARSET\fR -.RS 4 -Set the Unix codepage, used by atalkd and papd to convert extended characters from the Unix to the Mac codepage\&. Has to match the codepage of the configuration files\&. -.RE -.SH "SEE ALSO" -.PP -\fBafpd\fR(8), -\fBafpd.conf\fR(5), -\fBcnid_metad\fR(8), -\fBatalkd\fR(8), -\fBatalkd.conf\fR(5) -- 2.39.2