doc/FAQ

   1 Netatalk Frequently Asked Questions
   2 ($Id: FAQ,v 1.2 2001-10-15 16:28:33 lancel Exp $)
   3
   4 Compilation -----------------------------------------------------------------
   5
   6 Installation ----------------------------------------------------------------
   7
   8 Execution -------------------------------------------------------------------
   9
  10 Q: I get a "socket: Invalid argument" error when trying to start netatalk
  11    under Linux. What is causing this?
  12 A: The "appletalk" and "ipddp" kernel modules have to be installed under
  13    linux for netatalk to function. The appletalk module can be automatically
  14    loaded by adding the line "alias net-pf-5 appletalk" to the
  15    /etc/modules.conf file. Issuing the command "modprobe (module)" will
  16    load the module for the current session.
  17
  18 Q: netatalk works over Appletalk, but my IP connections are refused, even
  19    though I have enabled them in the configuration files.
  20 A: If tcp_wrappers support is compiled into netatalk, access has to be
  21    granted in /etc/hosts.allow for netatalk to successfully accept IP
  22    connections. This can be done by the addition of the line:
  23    afpd:  127. xxx.xxx.xxx. (whatever other subnets)
  24
  25 Q: Where can I get more information on Netatalk?
  26
  27 A: The current location of the actively developed netatalk project can be
  28 found on SourceForge, at: http:/www.sourceforge.net/projects/netatalk.
  29
  30 There are (at least) two very active e-mail lists to which you can
  31 subscribe, the first, netatalk-admins, is for usage and basic
  32 setup/compile questions. It is NOT maintained at sourceforge, but rather
  33 at the University of Michigan, which was involved with a good deal of the
  34 early development.
  35
  36 Subscribe by sending an e-mail to netatalk-admins-request@umich.edu with a
  37 subject of "subscribe" and a blank body. This can be very high volume, but
  38 usually a few messages a day.
  39
  40 The archive is available at:
  41 ftp://terminator.rs.itd.umich.edu/unix/netatalk/ and is called
  42 netatalk-admins.mail.  This is a ~6M mbox file. Previous archives are
  43 available there as well.
  44
  45 Netatalk-devel list is more specific to coding and testing. It can be
  46 browsed at: http://www.geocrawler.com/redir-sf.php3?list=netatalk-devel,
  47 and subscribed to at:
  48 http://lists.sourceforge.net/lists/listinfo/netatalk-devel This varies in
  49 volume, but is usually moderately active.
  50
  51 netatalk-docs is specific to documentation. It can be browsed at:
  52 http://www.geocrawler.com/redir-sf.php3?list=netatalk-docs
  53 and subscribed to at:
  54 http://lists.sourceforge.net/lists/listinfo/netatalk-docs
  55 As far as I can tell, this list is completely dead.
  56
  57 There are older netatlk information sites at:
  58 http://www.umich.edu/~rsug/netatalk/index.html
  59 http://www.anders.com/projects/netatalk/ and many unices have their own
  60 sites and distributions (tarballs, rpm's, packages, etc.)
  61
  62
  63 Q: How do I get the most recent version of Netatalk?
  64
  65 A: Via CVS from Sourceforge.net. This is the actively maintained version
  66 of netatalk, changes are being made constantly, and therefore it is not
  67 suitable for production environments. The netatalk at Sourceforge is in
  68 Beta, so keep that in mind.
  69
  70 To create the CVS tree - from the directory you want to use as your CVS
  71 root, run:
  72
  73 % cvs -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk login
  74
  75 hit <enter> at the Password: prompt
  76
  77 % cvs -z3
  78 -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk co
  79 netatalk
  80
  81 this will create a netatalk subdirectory, and check out all of the files.
  82 If you run this same command subsequently, you will update any files which
  83 have changed (on the CVS server) since your last checkout.
  84
  85 Once you've done that, read the INSTALL file in the netatalk/ directory,
  86 plus the CONFIGURE file. You'll need to have some supplementary software
  87 installed, such as gmake. Additional information can be found in docs/.
  88
  89 The main things to know, though, are this: you must run
  90
  91 % ./autogen.sh in the netatalk/ directory first, in order to create your
  92 configure file.
  93
  94 Then run % ./configure --help | more in order to get a
  95 feel for which compile flags are available. Some of these flags are
  96 summarized below.
  97
  98 To learn more about CVS, a good place to start is: http://www.cvshome.org,
  99 or http://www.cvshome.org/docs/manual, or
 100 http://www.cvshome.org/form/form.cgi (this is the FAQ).
 101
 102
 103 Q: Can I get an almost current version of Netatalk without having to learn CVS?
 104
 105 A: Yes.  Weekly (or thereabouts) snapshots of the CVS tree should be
 106 posted for the benefit of those that don't want to / can't use CVS. As of
 107 10/3/01, these were being put up at:
 108
 109 ftp://ftp.marcuscom.com/pub/netatalk/nightly
 110
 111 From the mail archives:
 112 I have started an archive of nightly CVS snap shots that build a tar.gz of
 113 netatalk ready to configure and build.  The images can be downloaded from:
 114
 115 ftp://ftp.marcuscom.com/pub/netatalk/nightly
 116 This site only allows active FTP, so the snaps are also available at:
 117 http://www.marcuscom.com/netatalk/nightly
 118
 119 You should be able to treat these images as you would a release.  Just
 120 configure as you normally work, then run make (or gmake as the case may
 121 be).  There is no need to run autogen.sh on these images.  Please let me
 122 know if you have any problems with these images.  Thanks. -Joe
 123
 124
 125 Q: What is this I keep seeing about asun?
 126
 127 A: Before netatalk moved to SourceForge, Adrian Sun (asun) had written
 128 some patches to netatalk which helped significantly with it's usability,
 129 especially using appleshareIP. These patches are still provided by many
 130 unix vendors. I believe all of these patches are included in the current
 131 Sourceforge versions.
 132
 133
 134 Q: I'm having Quark Express file locking problems, is there information on that?
 135
 136 A: Yes, see below about the --enable-did= flag. Also, try using the
 137 --flock-locks flag. Enabling this code disabled the new byte locking
 138 feature.  With FLOCK locks, the whole file would be locked.  With byte
 139 locks, a byte range could be locked without locking the whole file.
 140
 141
 142 Q: I'm getting this error in Quark Express when trying to save a file to
 143 the server: 'Error Type -50'
 144
 145 A: Turn off the document preview feature off in Quark.
 146
 147
 148 Q: Does netatalk work with Mac OSX?
 149
 150 A: Yes, but only the most recent versions, and it's still being finalized.
 151 Versions prior to 1.5Pre7 did NOT work with OS X, although some really
 152 early versions did (netatalk 1.4+asun?).
 153
 154
 155 Q: I'm getting an 'Application for this document not found' error on OS X.
 156
 157 Q: I'm getting an 'Error Type -43' error on OS X.
 158
 159 A: Configure with --with-did=last. More info on this flag is below.
 160
 161
 162 Q: What are the .AppleDouble and .Parent directories which are created in
 163 the netatalk locations?
 164
 165 A: (also mention samba veto files, and the appledouble/MSwindows options
 166 in AppleVolumes.default
 167
 168 The .AppleDouble folders hold the resource fork information for the mac
 169 files, plus other attributes which are not normally stored by Unix. For
 170 this reason, when you want to move files around in your mac volumes, it's
 171 a good idea to do it from the Mac side (as opposed to from the unix side,
 172 or Samba), unless you make absolutely sure you get the .AppleDouble
 173 directories. These directories are often hidden from the Samba side, via
 174 the veto files configuration.
 175
 176 You can also set netatalk to not create an .AppleDouble directory unless
 177 it absolutely needs it, by setting the noadouble setting in
 178 AppleVolumes.default.
 179
 180
 181 Q: Hidden files - what's up with that?
 182
 183 A: If you set the noadouble flag in AppleVolumes.default, you won't see
 184 the .Apple* or .Parent directories on the Mac side. If you use the veto
 185 files option in Samba, they may be hidden from the windows side as well.
 186
 187
 188 Q: How do I get the directories that are created by Netatalk to have the
 189 correct permissions by default?
 190
 191 A: Investigate the SetGid bit on your unix platform. It's a good idea to
 192 set this on your shared directories, and your .AppleDouble directories.
 193 From the mail archives: "Usually directories designated for use with
 194 AppleShare have the setgid (g+s) bit set.  It forces inheritance of
 195 permissions.  Without it, the .AppleDouble subdirectory can't be created
 196 since the new folder doesn't necessarily have the same write privileges."
 197
 198 Also: Evi Nemeth's "Unix System Administration Handbook" which is chock
 199 full of useful advice (and one or two pieces of not-so good advice, but
 200 even those are debatable). Here's what it says about setguid (3rd. ed,
 201 chap 5.5, pg. 69):
 202
 203 "The bits with octal values 4000 and 2000 are the setuid and setgid bits.
 204 These bits allow programs to acess files and processes that would
 205 otherwise be off-limits to the users that run them. ... When set on a
 206 directory, the setgid bit causes newly created files within the directory
 207 to take on the group membership of the directory rather than the defualt
 208 group of the user that created the file. This convention makes it easier
 209 to share a directory of files among several users, as long as they all
 210 belong to a common group. Check your system before relying on this
 211 feature, since not all version of UNIX provide it. ... This interpretation
 212 of the setgid bit is unrelated to it's meaning when set on an executable
 213 file, but there is never any ambiguity as to which meaning is
 214 appropriate." (any typos are mine)
 215
 216 NOTE: The SETUID is usually discussed along with the SetGID bit. The
 217 SetUID bit is VERY dangerous. If you set it on an executable, and the
 218 executable is owned by root, anyone who runs that executable is root for
 219 the duration of that executable's run, so a clever person can leverage
 220 that into a full-scale compromise. The SETGID bit also has implications
 221 that way, so be careful where you set it.
 222
 223 You set it by doing a chmod 2777 or 2775, or whatever. It's that first 2 bit.
 224
 225
 226 Q: How can I set who has access to certain directories?
 227
 228 A: You can certainly do this with your unix permissions, but also explore the
 229 allow/deny/rwlist/rolist options in the AppleVolumes.default file:
 230
 231 # allow/deny/rwlist/rolist format [syntax: allow:user1,@group]:
 232 # user1,@group,user2  -> allows/denies access from listed users/groups
 233 #                        rwlist/rolist control whether or not the
 234 #                        volume is ro for those users.
 235
 236 Also, some unices, specically FreeBSD, have other options:
 237 (By Joe Clark)
 238
 239 "What about file and directory permissions?  Since I didn't use the FORCE
 240 UID/GID code, I decided to use a feature of FreeBSD called SUIDDIR. From
 241 the LINT kernel config file:
 242
 243 # If you are running a machine just as a fileserver for PC and MAC
 244 # users, using SAMBA or Netatalk, you may consider setting this option
 245 # and keeping all those users' directories on a filesystem that is
 246 # mounted with the suiddir option. This gives new files the same
 247 # ownership as the directory (similar to group). It's a security hole
 248 # if you let these users run programs, so confine it to file-servers
 249 # (but it'll save you lots of headaches in those cases). Root owned
 250 # directories are exempt and X bits are cleared. The suid bit must be
 251 # set on the directory as well; see chmod(1) PC owners can't see/set
 252 # ownerships so they keep getting their toes trodden on. This saves
 253 # you all the support calls as the filesystem it's used on will act as
 254 # they expect: "It's my dir so it must be my file".
 255
 256  FORCE UID/GID code, I decided to use a feature of FreeBSD called
 257  SUIDDIR.  From the LINT kernel config file:
 258
 259 # If you are running a machine just as a fileserver for PC and MAC
 260 # users, using SAMBA or Netatalk, you may consider setting this option
 261 # and keeping all those users' directories on a filesystem that is
 262 # mounted with the suiddir option. This gives new files the same
 263 # ownership as the directory (similar to group). It's a security hole
 264 # if you let these users run programs, so confine it to file-servers
 265 # (but it'll save you lots of headaches in those cases). Root owned
 266 # directories are exempt and X bits are cleared. The suid bit must be
 267 # set on the directory as well; see chmod(1) PC owners can't see/set
 268 # ownerships so they keep getting their toes trodden on. This saves
 269 # you all the support calls as the filesystem it's used on will act as
 270 # they expect: "It's my dir so it must be my file".
 271
 272 And the associated mount command:
 273
 274 mount -o suiddir /dev/da2s1e /macvol/artfiles
 275
 276 This was used on my dedicated Netatalk/Samba filesystems.  On
 277 filesystems that were also used for interactive shell access, I chmod'd
 278 my Netatalk shares 2770.  The reason for this is that I set up a UNIX
 279 group for each department in the ad agency.  I had an art group, a media
 280 group, an accounting group, and then, or course, a general staff group.
 281 Each share was only allowed access by the group that needed to access
 282 the share.  So, the Artfiles share allowed access only to the art group:
 283
 284 /macvol/artfiles "Art Files" allow:@art
 285
 286 And the others followed in kind.  Therefore, the 2770 mask allowed only
 287 owners and people in the associated group access to read and write
 288 files.  The leading 2 set the setgid bit so that all child files and
 289 directories would retain the same group permissions.  I found this to
 290 work well.
 291
 292 This was used on my dedicated Netatalk/Samba filesystems.  On
 293 filesystems that were also used for interactive shell access, I chmod'd
 294 my Netatalk shares 2770.  The reason for this is that I set up a UNIX
 295 group for each department in the ad agency.  I had an art group, a media
 296 group, an accounting group, and then, or course, a general staff group.
 297 Each share was only allowed access by the group that needed to access
 298 the share.  So, the Artfiles share allowed access only to the art group:
 299
 300 /macvol/artfiles "Art Files" allow:@art
 301
 302 And the others followed in kind.  Therefore, the 2770 mask allowed only
 303 owners and people in the associated group access to read and write
 304 files.  The leading 2 set the setgid bit so that all child files and
 305 directories would retain the same group permissions.  I found this to
 306 work well."
 307
 308
 309
 310 Q: I can't seem to use passwords longer than 8 characters for my netatalk
 311 accounts. How can I fix that?
 312
 313 Q: I would like to use encrypted passwords to authenticate to the Netatalk
 314 server. How do I do that?
 315
 316 A: Update to a newer version of AppleShare Client (I think the most recent is 3.8.8). This allows longer passwords, and will allow you to use encrypted passwords. Set which way you would like to authenticate in either afpd.conf or netatalk.conf, depending on your set up.
 317
 318
 319 Q: I'm having massive file deletion problems!
 320 Q: I am having lots of file locking problems!
 321 Q: I'm getting this message in my logs:
 322 WARNING: DID conflict for ...  Are these the same file?
 323
 324 A: Compile with the --with-did=last flag set. This activates a different
 325 method of calculating inodes in the software, and will hopefully fix some
 326 of these problems. This code, along with the CNID code, was still being
 327 worked out in Pre7. The cnid/db3 flags also go along with this:
 328   --enable-cnid-db   use persistent cnid database per volume (EXPERIMENTAL)
 329   --with-db3=PATH         specify path to Berkeley DB3 installation
 330   --with-did=[scheme]     set DID scheme (last,mtab)
 331
 332 (For more information on CNID, see the README.cnid file, into which I just
 333 copied wholesale Joe's comments on what he did with cnid and lastdid.)
 334
 335 --with-did=last reverted things back to the old 1.4b2 directory ID
 336 calculation algorithm.  This also solved the problem of the syslog
 337 messages and the users complaining of file deletions.  It's also been
 338 found that by disabling *BSD's SOFTUPDATES feature on Netatalk volumes (on
 339 FreeBSD), multi-user interaction seemed to work better.  This was back in
 340 a late 4.2-BETA, so it's not clear if this still holds true in 4.4-RELEASE
 341 or not.
 342
 343
 344 Q: What does this error mean:
 345 'afpd[#####]: setdirmode: chmod .AppleDouble Operation not permitted'
 346
 347 A: This can be due to a few things.
 348
 349 1) The SetGid bit might not be set on either your directory, or on the
 350 .AppleDouble directory. I think the bit has to be set recursively on the
 351 .AppleDouble folder.
 352
 353 2) You may not be member of the group set on the directory you're trying
 354 to write to.
 355
 356 3) This was a persistant bug in 1.5pre6 for awhile, upgrading might help.
 357
 358
 359 Q: I'm having problems with the Trash folder: either when someone drags
 360 files into it, the system want's them todelete them immeidately, or files
 361 get stuck in there and won't delete.
 362
 363 A: chmod the Network Trash folder to 2775 (/home/public/Network Trash
 364 Folder for instance).
 365
 366
 367 Q: The daemons aren't starting, things aren't showing up in the Chooser,
 368 and I get a message like this in the logs: afpd[####]: Can't register
 369 Tests:AFPServer@*
 370
 371 This is sometimes a result of missing NIC information in the atalkd.conf
 372 file. Put your network interface (something like le0, eth0, fxp0, lo0)
 373 alone on a line in atalkd.conf, and reboot. When atalkd starts, it will
 374 populate the file with a line like: le1 -seed -phase 2 -addr 66.6 -net
 375 66-67 -zone "No Parking"
 376
 377 To find your network interface, run
 378
 379 % ifconfig -a | more
 380 and see which interface has your IP address. Use that one.
 381
 382 (much of this stuff has been pulled out of the mail archives, and from
 383 informational files sent by Joe Clark.)
 384
 385
 386 -                                                                  -
 387     Karen Swanberg | Sys Admin | Dept. of Geology and Geophysics
 388 206 Pillsbury Hall | 310 Pillsbury Ave. SE | University of Minnesota
 389      Minneapolis, MN 55455  (612) 624-6541  (612) 625-3819 (f)
 390
 391               * <---- Tribble   . <--- Tribble.tgz
 392
 393
 394 _______________________________________________
 395 Netatalk-devel mailing list
 396 Netatalk-devel@lists.sourceforge.net
 397 https://lists.sourceforge.net/lists/listinfo/netatalk-devel
 398
 399 From netatalk-devel-admin@lists.sourceforge.net  Thu Oct  4 18:31:07 2001
 400 Return-Path: <netatalk-devel-admin@lists.sourceforge.net>
 401 Delivered-To: lance@cossette.dante.ca
 402 Received: from localhost (localhost [127.0.0.1])
 403         by cossette.dante.ca (Postfix) with ESMTP id 236EF7B71
 404         for <lance@cossette.dante.ca>; Thu,  4 Oct 2001 18:31:07 -0600 (CST)
 405 Received: from mail.printwest.com [142.165.62.112]
 406         by localhost with POP3 (fetchmail-5.9.3)
 407         for lance@cossette.dante.ca (single-drop); Thu, 04 Oct 2001 18:31:07 -0600 (CST)
 408 Received: from pathfinder (192.168.10.10)
 409           by pathfinder with MERCUR-SMTP/POP3/IMAP4-Server (v3.30.09 AS-0098315)
 410           for <l.levsen@printwest.com>; Thu, 4 Oct 2001  19:03:44 -0600
 411 Received: from usw-sf-list1.sourceforge.net ([192.168.10.1])
 412  by pathfinder (NAVIEG 2.1 bld 63) with SMTP id M2001100419034222100
 413  for <l.levsen@printwest.com>; Thu, 04 Oct 2001 19:03:43 -0600
 414 Received: from SMTP agent by mail gateway
 415  Thu, 04 Oct 2001 18:57:03 -0600
 416 Received: from localhost ([127.0.0.1] helo=usw-sf-list1.sourceforge.net)
 417         by usw-sf-list1.sourceforge.net with esmtp (Exim 3.31-VA-mm2 #1 (Debian))
 418         id 15pJ22-0003Gx-00; Thu, 04 Oct 2001 17:40:02 -0700
 419 Received: from mhub-w4.tc.umn.edu ([160.94.160.49])
 420         by usw-sf-list1.sourceforge.net with esmtp (Exim 3.31-VA-mm2 #1 (Debian))
 421         id 15pJ15-00035w-00
 422         for <netatalk-devel@lists.sourceforge.net>; Thu, 04 Oct 2001 17:39:03 -0700
 423 Received: from garnet.tc.umn.edu by mhub-w4.tc.umn.edu with ESMTP for netatalk-devel@lists.sourceforge.net; Thu, 4 Oct 2001 19:39:01 -0500
 424 Received: from localhost by garnet.tc.umn.edu with ESMTP; Thu, 4 Oct 2001 19:39:00 -0500
 425 From: Karen A Swanberg <swanberg@tc.umn.edu>
 426 To: netatalk-admins@umich.edu, netatalk-devel@lists.sourceforge.net
 427 Message-Id: <Pine.SOL.4.20.0110041930430.16268-100000@garnet.tc.umn.edu>
 428 MIME-Version: 1.0
 429 Content-Type: TEXT/PLAIN; charset=US-ASCII
 430 Subject: [Netatalk-devel] new FAQ, pt. 1 (long)
 431 Sender: netatalk-devel-admin@lists.sourceforge.net
 432 Errors-To: netatalk-devel-admin@lists.sourceforge.net
 433 X-BeenThere: netatalk-devel@lists.sourceforge.net
 434 X-Mailman-Version: 2.0.5
 435 Precedence: bulk
 436 List-Help: <mailto:netatalk-devel-request@lists.sourceforge.net?subject=help>
 437 List-Post: <mailto:netatalk-devel@lists.sourceforge.net>
 438 List-Subscribe: <https://lists.sourceforge.net/lists/listinfo/netatalk-devel>,
 439         <mailto:netatalk-devel-request@lists.sourceforge.net?subject=subscribe>
 440 List-Id: <netatalk-devel.lists.sourceforge.net>
 441 List-Unsubscribe: <https://lists.sourceforge.net/lists/listinfo/netatalk-devel>,
 442         <mailto:netatalk-devel-request@lists.sourceforge.net?subject=unsubscribe>
 443 List-Archive: <https://lists.sourceforge.net/archives//netatalk-devel/>
 444 X-Original-Date: Thu, 4 Oct 2001 19:39:00 -0500 (CDT)
 445 Date: Thu, 4 Oct 2001 19:39:00 -0500 (CDT)
 446
 447
 448 Here's my first version of a FAQ, to be added to the current, or whatever
 449 else the maintainers want to do with it. I'm posting it to see of there
 450 are any glaring errors, if people want me to answer other questions, or
 451 any other comments. It hasn't been spell-checked, don't worry about the
 452 any typos.
 453
 454 Notes - I'm writing this for a newbie reader; as one person once said to
 455 me the target audience for this software is an overworked high-school
 456 admin who is maintaining a lab in her spare time, not a *bsd god.
 457 Nevertheless, if there are any simplications which I have done which
 458 confuse things, please let me know. I intend on putting in a "how to make
 459 netatalk play nice(r) with samba" section too, if anyone has any
 460 suggestions for it, PLEASE, let me know.
 461
 462 Three main questions I still have:
 463
 464 Where does netatalk.conf fit into all of this? It seems that it's
 465 redundant in a lot of ways. Is this a file that is staring to be used like
 466 smb.conf, it's just not there yet?
 467
 468 What's the final solution (or has it been solved) for the trash problems?
 469 Both the "delete files immediately" and the files getting stuck in there
 470 with permission problems?
 471
 472 Has the folder refresh problem been fixed? If not, what should I put in
 473 here about it? Having people view their folders as lists, and open and
 474 close the triangle?
 475
 476 --FAQ--
 477
 478
 479 Q: Where can I get more information on Netatalk?
 480
 481 A: The current location of the actively developed netatalk project can be
 482 found on SourceForge, at: http:/www.sourceforge.net/projects/netatalk.
 483
 484 There are (at least) two very active e-mail lists to which you can
 485 subscribe, the first, netatalk-admins, is for usage and basic
 486 setup/compile questions. It is NOT maintained at sourceforge, but rather
 487 at the University of Michigan, which was involved with a good deal of the
 488 early development.
 489
 490 Subscribe by sending an e-mail to netatalk-admins-request@umich.edu with a
 491 subject of "subscribe" and a blank body. This can be very high volume, but
 492 usually a few messages a day.
 493
 494 The archive is available at:
 495 ftp://terminator.rs.itd.umich.edu/unix/netatalk/ and is called
 496 netatalk-admins.mail.  This is a ~6M mbox file. Previous archives are
 497 available there as well.
 498
 499 Netatalk-devel list is more specific to coding and testing. It can be
 500 browsed at: http://www.geocrawler.com/redir-sf.php3?list=netatalk-devel,
 501 and subscribed to at:
 502 http://lists.sourceforge.net/lists/listinfo/netatalk-devel This varies in
 503 volume, but is usually moderately active.
 504
 505 netatalk-docs is specific to documentation. It can be browsed at:
 506 http://www.geocrawler.com/redir-sf.php3?list=netatalk-docs
 507 and subscribed to at:
 508 http://lists.sourceforge.net/lists/listinfo/netatalk-docs
 509 As far as I can tell, this list is completely dead.
 510
 511 There are older netatlk information sites at:
 512 http://www.umich.edu/~rsug/netatalk/index.html
 513 http://www.anders.com/projects/netatalk/ and many unices have their own
 514 sites and distributions (tarballs, rpm's, packages, etc.)
 515
 516
 517 Q: How do I get the most recent version of Netatalk?
 518
 519 A: Via CVS from Sourceforge.net. This is the actively maintained version
 520 of netatalk, changes are being made constantly, and therefore it is not
 521 suitable for production environments. The netatalk at Sourceforge is in
 522 Beta, so keep that in mind.
 523
 524 To create the CVS tree - from the directory you want to use as your CVS
 525 root, run:
 526
 527 % cvs -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk login
 528
 529 hit <enter> at the Password: prompt
 530
 531 % cvs -z3
 532 -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk co
 533 netatalk
 534
 535 this will create a netatalk subdirectory, and check out all of the files.
 536 If you run this same command subsequently, you will update any files which
 537 have changed (on the CVS server) since your last checkout.
 538
 539 Once you've done that, read the INSTALL file in the netatalk/ directory,
 540 plus the CONFIGURE file. You'll need to have some supplementary software
 541 installed, such as gmake. Additional information can be found in docs/.
 542
 543 The main things to know, though, are this: you must run
 544
 545 % ./autogen.sh in the netatalk/ directory first, in order to create your
 546 configure file.
 547
 548 Then run % ./configure --help | more in order to get a
 549 feel for which compile flags are available. Some of these flags are
 550 summarized below.
 551
 552 To learn more about CVS, a good place to start is: http://www.cvshome.org,
 553 or http://www.cvshome.org/docs/manual, or
 554 http://www.cvshome.org/form/form.cgi (this is the FAQ).
 555
 556
 557 Q: Can I get an almost current version of Netatalk without having to learn CVS?
 558
 559 A: Yes.  Weekly (or thereabouts) snapshots of the CVS tree should be
 560 posted for the benefit of those that don't want to / can't use CVS. As of
 561 10/3/01, these were being put up at:
 562
 563 ftp://ftp.marcuscom.com/pub/netatalk/nightly
 564
 565 From the mail archives:
 566 I have started an archive of nightly CVS snap shots that build a tar.gz of
 567 netatalk ready to configure and build.  The images can be downloaded from:
 568
 569 ftp://ftp.marcuscom.com/pub/netatalk/nightly
 570 This site only allows active FTP, so the snaps are also available at:
 571 http://www.marcuscom.com/netatalk/nightly
 572
 573 You should be able to treat these images as you would a release.  Just
 574 configure as you normally work, then run make (or gmake as the case may
 575 be).  There is no need to run autogen.sh on these images.  Please let me
 576 know if you have any problems with these images.  Thanks. -Joe
 577
 578
 579 Q: What is this I keep seeing about asun?
 580
 581 A: Before netatalk moved to SourceForge, Adrian Sun (asun) had written
 582 some patches to netatalk which helped significantly with it's usability,
 583 especially using appleshareIP. These patches are still provided by many
 584 unix vendors. I believe all of these patches are included in the current
 585 Sourceforge versions.
 586
 587
 588 Q: I'm having Quark Express file locking problems, is there information on that?
 589
 590 A: Yes, see below about the --enable-did= flag. Also, try using the
 591 --flock-locks flag. Enabling this code disabled the new byte locking
 592 feature.  With FLOCK locks, the whole file would be locked.  With byte
 593 locks, a byte range could be locked without locking the whole file.
 594
 595
 596 Q: I'm getting this error in Quark Express when trying to save a file to
 597 the server: 'Error Type -50'
 598
 599 A: Turn off the document preview feature off in Quark.
 600
 601
 602 Q: Does netatalk work with Mac OSX?
 603
 604 A: Yes, but only the most recent versions, and it's still being finalized.
 605 Versions prior to 1.5Pre7 did NOT work with OS X, although some really
 606 early versions did (netatalk 1.4+asun?).
 607
 608
 609 Q: I'm getting an 'Application for this document not found' error on OS X.
 610
 611 Q: I'm getting an 'Error Type -43' error on OS X.
 612
 613 A: Configure with --with-did=last. More info on this flag is below.
 614
 615
 616 Q: What are the .AppleDouble and .Parent directories which are created in
 617 the netatalk locations?
 618
 619 A: (also mention samba veto files, and the appledouble/MSwindows options
 620 in AppleVolumes.default
 621
 622 The .AppleDouble folders hold the resource fork information for the mac
 623 files, plus other attributes which are not normally stored by Unix. For
 624 this reason, when you want to move files around in your mac volumes, it's
 625 a good idea to do it from the Mac side (as opposed to from the unix side,
 626 or Samba), unless you make absolutely sure you get the .AppleDouble
 627 directories. These directories are often hidden from the Samba side, via
 628 the veto files configuration.
 629
 630 You can also set netatalk to not create an .AppleDouble directory unless
 631 it absolutely needs it, by setting the noadouble setting in
 632 AppleVolumes.default.
 633
 634
 635 Q: Hidden files - what's up with that?
 636
 637 A: If you set the noadouble flag in AppleVolumes.default, you won't see
 638 the .Apple* or .Parent directories on the Mac side. If you use the veto
 639 files option in Samba, they may be hidden from the windows side as well.
 640
 641
 642 Q: How do I get the directories that are created by Netatalk to have the
 643 correct permissions by default?
 644
 645 A: Investigate the SetGid bit on your unix platform. It's a good idea to
 646 set this on your shared directories, and your .AppleDouble directories.
 647 From the mail archives: "Usually directories designated for use with
 648 AppleShare have the setgid (g+s) bit set.  It forces inheritance of
 649 permissions.  Without it, the .AppleDouble subdirectory can't be created
 650 since the new folder doesn't necessarily have the same write privileges."
 651
 652 Also: Evi Nemeth's "Unix System Administration Handbook" which is chock
 653 full of useful advice (and one or two pieces of not-so good advice, but
 654 even those are debatable). Here's what it says about setguid (3rd. ed,
 655 chap 5.5, pg. 69):
 656
 657 "The bits with octal values 4000 and 2000 are the setuid and setgid bits.
 658 These bits allow programs to acess files and processes that would
 659 otherwise be off-limits to the users that run them. ... When set on a
 660 directory, the setgid bit causes newly created files within the directory
 661 to take on the group membership of the directory rather than the defualt
 662 group of the user that created the file. This convention makes it easier
 663 to share a directory of files among several users, as long as they all
 664 belong to a common group. Check your system before relying on this
 665 feature, since not all version of UNIX provide it. ... This interpretation
 666 of the setgid bit is unrelated to it's meaning when set on an executable
 667 file, but there is never any ambiguity as to which meaning is
 668 appropriate." (any typos are mine)
 669
 670 NOTE: The SETUID is usually discussed along with the SetGID bit. The
 671 SetUID bit is VERY dangerous. If you set it on an executable, and the
 672 executable is owned by root, anyone who runs that executable is root for
 673 the duration of that executable's run, so a clever person can leverage
 674 that into a full-scale compromise. The SETGID bit also has implications
 675 that way, so be careful where you set it.
 676
 677 You set it by doing a chmod 2777 or 2775, or whatever. It's that first 2 bit.
 678
 679
 680 Q: How can I set who has access to certain directories?
 681
 682 A: You can certainly do this with your unix permissions, but also explore the
 683 allow/deny/rwlist/rolist options in the AppleVolumes.default file:
 684
 685 # allow/deny/rwlist/rolist format [syntax: allow:user1,@group]:
 686 # user1,@group,user2  -> allows/denies access from listed users/groups
 687 #                        rwlist/rolist control whether or not the
 688 #                        volume is ro for those users.
 689
 690 Also, some unices, specically FreeBSD, have other options:
 691 (By Joe Clark)
 692
 693 "What about file and directory permissions?  Since I didn't use the FORCE
 694 UID/GID code, I decided to use a feature of FreeBSD called SUIDDIR. From
 695 the LINT kernel config file:
 696
 697 # If you are running a machine just as a fileserver for PC and MAC
 698 # users, using SAMBA or Netatalk, you may consider setting this option
 699 # and keeping all those users' directories on a filesystem that is
 700 # mounted with the suiddir option. This gives new files the same
 701 # ownership as the directory (similar to group). It's a security hole
 702 # if you let these users run programs, so confine it to file-servers
 703 # (but it'll save you lots of headaches in those cases). Root owned
 704 # directories are exempt and X bits are cleared. The suid bit must be
 705 # set on the directory as well; see chmod(1) PC owners can't see/set
 706 # ownerships so they keep getting their toes trodden on. This saves
 707 # you all the support calls as the filesystem it's used on will act as
 708 # they expect: "It's my dir so it must be my file".
 709
 710  FORCE UID/GID code, I decided to use a feature of FreeBSD called
 711  SUIDDIR.  From the LINT kernel config file:
 712
 713 # If you are running a machine just as a fileserver for PC and MAC
 714 # users, using SAMBA or Netatalk, you may consider setting this option
 715 # and keeping all those users' directories on a filesystem that is
 716 # mounted with the suiddir option. This gives new files the same
 717 # ownership as the directory (similar to group). It's a security hole
 718 # if you let these users run programs, so confine it to file-servers
 719 # (but it'll save you lots of headaches in those cases). Root owned
 720 # directories are exempt and X bits are cleared. The suid bit must be
 721 # set on the directory as well; see chmod(1) PC owners can't see/set
 722 # ownerships so they keep getting their toes trodden on. This saves
 723 # you all the support calls as the filesystem it's used on will act as
 724 # they expect: "It's my dir so it must be my file".
 725
 726 And the associated mount command:
 727
 728 mount -o suiddir /dev/da2s1e /macvol/artfiles
 729
 730 This was used on my dedicated Netatalk/Samba filesystems.  On
 731 filesystems that were also used for interactive shell access, I chmod'd
 732 my Netatalk shares 2770.  The reason for this is that I set up a UNIX
 733 group for each department in the ad agency.  I had an art group, a media
 734 group, an accounting group, and then, or course, a general staff group.
 735 Each share was only allowed access by the group that needed to access
 736 the share.  So, the Artfiles share allowed access only to the art group:
 737
 738 /macvol/artfiles "Art Files" allow:@art
 739
 740 And the others followed in kind.  Therefore, the 2770 mask allowed only
 741 owners and people in the associated group access to read and write
 742 files.  The leading 2 set the setgid bit so that all child files and
 743 directories would retain the same group permissions.  I found this to
 744 work well.
 745
 746 This was used on my dedicated Netatalk/Samba filesystems.  On
 747 filesystems that were also used for interactive shell access, I chmod'd
 748 my Netatalk shares 2770.  The reason for this is that I set up a UNIX
 749 group for each department in the ad agency.  I had an art group, a media
 750 group, an accounting group, and then, or course, a general staff group.
 751 Each share was only allowed access by the group that needed to access
 752 the share.  So, the Artfiles share allowed access only to the art group:
 753
 754 /macvol/artfiles "Art Files" allow:@art
 755
 756 And the others followed in kind.  Therefore, the 2770 mask allowed only
 757 owners and people in the associated group access to read and write
 758 files.  The leading 2 set the setgid bit so that all child files and
 759 directories would retain the same group permissions.  I found this to
 760 work well."
 761
 762
 763
 764 Q: I can't seem to use passwords longer than 8 characters for my netatalk
 765 accounts. How can I fix that?
 766
 767 Q: I would like to use encrypted passwords to authenticate to the Netatalk
 768 server. How do I do that?
 769
 770 A: Update to a newer version of AppleShare Client (I think the most recent is 3.8.8). This allows longer passwords, and will allow you to use encrypted passwords. Set which way you would like to authenticate in either afpd.conf or netatalk.conf, depending on your set up.
 771
 772
 773 Q: I'm having massive file deletion problems!
 774 Q: I am having lots of file locking problems!
 775 Q: I'm getting this message in my logs:
 776 WARNING: DID conflict for ...  Are these the same file?
 777
 778 A: Compile with the --with-did=last flag set. This activates a different
 779 method of calculating inodes in the software, and will hopefully fix some
 780 of these problems. This code, along with the CNID code, was still being
 781 worked out in Pre7. The cnid/db3 flags also go along with this:
 782   --enable-cnid-db   use persistent cnid database per volume (EXPERIMENTAL)
 783   --with-db3=PATH         specify path to Berkeley DB3 installation
 784   --with-did=[scheme]     set DID scheme (last,mtab)
 785
 786 (For more information on CNID, see the README.cnid file, into which I just
 787 copied wholesale Joe's comments on what he did with cnid and lastdid.)
 788
 789 --with-did=last reverted things back to the old 1.4b2 directory ID
 790 calculation algorithm.  This also solved the problem of the syslog
 791 messages and the users complaining of file deletions.  It's also been
 792 found that by disabling *BSD's SOFTUPDATES feature on Netatalk volumes (on
 793 FreeBSD), multi-user interaction seemed to work better.  This was back in
 794 a late 4.2-BETA, so it's not clear if this still holds true in 4.4-RELEASE
 795 or not.
 796
 797
 798 Q: What does this error mean:
 799 'afpd[#####]: setdirmode: chmod .AppleDouble Operation not permitted'
 800
 801 A: This can be due to a few things.
 802
 803 1) The SetGid bit might not be set on either your directory, or on the
 804 .AppleDouble directory. I think the bit has to be set recursively on the
 805 .AppleDouble folder.
 806
 807 2) You may not be member of the group set on the directory you're trying
 808 to write to.
 809
 810 3) This was a persistant bug in 1.5pre6 for awhile, upgrading might help.
 811
 812
 813 Q: I'm having problems with the Trash folder: either when someone drags
 814 files into it, the system want's them todelete them immeidately, or files
 815 get stuck in there and won't delete.
 816
 817 A: chmod the Network Trash folder to 2775 (/home/public/Network Trash
 818 Folder for instance).
 819
 820
 821 Q: The daemons aren't starting, things aren't showing up in the Chooser,
 822 and I get a message like this in the logs: afpd[####]: Can't register
 823 Tests:AFPServer@*
 824
 825 This is sometimes a result of missing NIC information in the atalkd.conf
 826 file. Put your network interface (something like le0, eth0, fxp0, lo0)
 827 alone on a line in atalkd.conf, and reboot. When atalkd starts, it will
 828 populate the file with a line like: le1 -seed -phase 2 -addr 66.6 -net
 829 66-67 -zone "No Parking"
 830
 831 To find your network interface, run
 832
 833 % ifconfig -a | more
 834 and see which interface has your IP address. Use that one.
 835
 836 (much of this stuff has been pulled out of the mail archives, and from
 837 informational files sent by Joe Clark.)
 838
 839
 840 -                                                                  -
 841     Karen Swanberg | Sys Admin | Dept. of Geology and Geophysics
 842 206 Pillsbury Hall | 310 Pillsbury Ave. SE | University of Minnesota
 843      Minneapolis, MN 55455  (612) 624-6541  (612) 625-3819 (f)
 844
 845               * <---- Tribble   . <--- Tribble.tgz
 846
 847
 848 _______________________________________________
 849 Netatalk-devel mailing list
 850 Netatalk-devel@lists.sourceforge.net
 851 https://lists.sourceforge.net/lists/listinfo/netatalk-devel
 852