AFPTCP Command Line Options

  • 7002154
  • 10-Dec-2008
  • 27-Apr-2012

Environment

NFAP for Macintosh (AFP)
Native File Access Pack (NFAP) for NetWare 6.0
Native File Access Pack (NFAP) for NetWare 5.1
NFAP v 1.0

Situation

AFPTCP Command Line Options

Resolution

AFPTCP Command Line Options

cleartext

Enables cleartext login.  The password that is entered on the Mac will go over the wire unencrypted.  AFPTCP will first try to use it as a Simple Password.  If that fails, AFPTCP will try to it as the NDS password.  If that succeeds, AFPTCP will then set the Simple Password to this proven NDS password.

This is intended for startup and an easy way to get users a simple password that is in synch with their NDS password.  The user can start AFPTCP with the cleartext option, run that way until everyone has had a chance to login once (say, a week) then reload AFPTCP without the cleartext option

count

This will give an exact count of the number of offspring in a directory.  Turning this option on will impact performance negatively.  When asked for an offpsring count, AFPTCP looks to see if there are any files or folders in the target folder.  If the folder is empty, AFPTCP returns 0.  If AFPTCP finds at least one entry in the folder, AFPTCP returns 100.  This lie is told to improve performance.

This is intended to fix a problem seen with Mac OS X machines.  When dragging folders to the trash, if the offspring count is wrong, the folder will not be deleted.  The files in the folder will have to be dragged to the trash first, then the folder.  You will see this problem anywhere a folder is being deleted.  If you copy a folder over a folder of the same name, the destination folder will be deleted first, then the copy begins.  This preparatory delete will fail, and the file copy will fail.  These problems are not seen on Mac OS 9.  Setting the count option will fix the problems with deleting a folder.

noSharing

This turns off fetching rights for the owner, groups, and everyone and returns a set of default rights when asked.  The rights for the current user are returned accurately and GUI clues on the Mac will be accurate (i.e. a pen will appear on the folder if you have write rights).

This is intended to bypass performance problems if the request for rights results in a query going off the box.  If the DS query goes off the box, a delay of  20 seconds or more may be experienced. 

This will disable the ability of Mac users to use the "file sharing" dialog.  The File Sharing dialog allows users to assign a group or user rights to a folder (or assign a group or user as owner).  In place of  user and group names the message (Use NetWare Utilities) is displayed.  In general, it is preferred that NetWare utilities be used to setup rights assignments.  The file sharing dialog is seen as an easy way for teachers to assign rights for a class to a folder from the Mac.

returnDefaultRights

This takes the "noSharing" option one step further and doesn't even look up rights for the current user.  When any rights are requested, a standard set of default rights are returned.  NetWare will still enforce the current user's rights, but they user may see inaccurate GUI clues. For example, he may see a pen on a folder indicating he has write access, when in fact he has read only access. Another example, a folder which is intended to be a drop box will have an icon for a regular folder instead of the drop box icon.

This is intended for testing purposes.  If the noSharing option doesn't improve performance, you can try this option and see if performance improves.  If no improvement is seen, the poor performance is not this DS problem.

log

This option logs some errors or potential errors and general status statements to sys:\etc\afptcp.log

If you are interested in a particular error, start AFPTCP with the log option, navigate on the Mac to just before the error occurs, delete sys:\etc\afptcp.log to clear out the current entries, then do the one click or keystroke that triggers the error.  Rename the afptcp.log file.  This will isolate the entries in  the log file to just those that occurred during the problem.

Not all errors are logged. Some entries that are made are not really errors, but more a status message.  For example if a file is not found, that will be logged, although it may not really be an error. It could be the Mac was just checking to see if the file existed.  It is kind of a hit and miss thing, but may provide some clues.  This is especially useful for login problems.

guest

This option enables the "guest" radio button on the Mac login dialog.  Without this option, the "guest" option will be grayed out.

In order to login as guest, the admin must set up a guest account with no password.  If the guest account has a password, the guest login will not work.

If this option is used, the "guest" radio button will be available.  If the user selects the radio button, there is no opporunity to enter a password and the user is logged in as guest with whatever rights have been assigned to guest.

threads <n>

This sets the number of threads that AFPTCP use s to process AFP traffic.  The default is 32 threads.  You can set it from anywhere from 1 to 32.  Since this NLM is not multi-processor aware, all threads are running on the same processor and having more threads may not give you better performance.  In fact, having less threads may give you better performance. 

This was intended for testing purposes and to see what effect on performance the number of threads may have. Each thread makes an unlicenses connection. You can decrease the number of unlicensed connections by decreasing the number of threads.

NoUnloadCheck

This will not check for active connections at unload time. It will simply unload the NLM regardless of who is connected and what files they may have open.

It could be used as a workaround for the NetWare 5.1 unload problem, where the NLM will not unload after the check.  If you eliminate the check, the NLM will unload, however, you will have no warning about active connections and open files.

RenameFromNWVolName

This allows NetWare volume names to be used in the afpvol.cfg file when renaming volumes.

 

You can use any combination of options in any order on the command line.  Example,

    load afptcp cleartext log count
 

.

Additional Information

DTRESET <AFP volume name> - This is a console command which will reset (rebuild) the desktop database.  Some users have complained that occasionally they get  a -50 error and when they do, rebuilding the desktop is their solution.  This starts the rebuild and displays a message when it is complete. Each volume has a desktop.  Do NOT rebuild more than one desktop at a time. There are no checks to prevent you from doing this, but if you do, you can abend the server.  Running just one desktop rebuild at a time, does not have a problem.

The syntax for the DTRESET command takes the AFP volume name as a parameter. The AFP volume name is the volume name as it appears in chooser.  The default volume name is server.volume and may be renamed through afpvol.cfg.
Formerly known as TID# 10072783