A.3. AFS Credentials System Tray Tool parameters

Affects the behavior of afscreds.exe

Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]

Value: Gateway

Type: REG_SZ

Default: ""

Function: GetGatewayName()

If the AFS client is utilizing a gateway to obtain AFS access, the name of the gateway is specified by this value.

Value: Cell

Type: REG_SZ

Default: <none>

Variable: IsServiceConfigured()

The value Cell is used to determine if the AFS Client Service has been properly configured or not.

Regkey: [HKLM\SOFTWARE\OpenAFS\Client] [HKCU\SOFTWARE\OpenAFS\Client]

Value: ShowTrayIcon

Type: DWORD {0, 1}

Default: 1

Function: InitApp(), Main_OnCheckTerminate()

This value is used to determine whether or not a shortcut should be maintained in the user's Start Menu->Programs->Startup folder.

This value used to be stored at [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].

The current user value is checked first; if it does not exist the local machine value is checked.

Value: EnableKFW

Type: DWORD {0, 1}

Default: 1

Function: KFW_is_available()

When MIT Kerberos for Windows can be loaded, Kerberos v5 will be used to obtain AFS credentials.  By setting this value to 0, the internal Kerberos v4 implementation will be used instead.  The current user value is checked first; if it does not exist the local machine value is checked.

Value: AcceptDottedPrincipalNames

Type: DWORD {0, 1}

Default: 1

Function: KFW_accept_dotted_usernames()

Kerberos v5 principal names are traditionally mapped to Kerberos v4 names by the AFS servers before they can be looked up in the Protection database.  The mapping algorithm used permits collisions to occur.  Both of the Kerberos v5 names, "user.admin@REALM" and "user/admin@REALM" are interpreted as the same user identity within the cell.  To enable both names to be sent to the server by AFSCreds or Integrated Logon, set this value to 1.

Value: Use524

Type: DWORD {0, 1}

Default: 0

Function: KFW_use_krb524()

When MIT Kerberos for Windows can be loaded, Kerberos v5 will be used to obtain AFS credentials.  By setting this value to 1, the Kerberos v5 tickets will be converted to Kerberos v4 tokens via a call to the krb524 daemon.  The current user value is checked first; if it does not exist the local machine value is checked.

Value: AfscredsShortcutParams

Type: REG_SZ

Default: "-A -M -N -Q"

Function: Shortcut_FixStartup

This value specifies the command line options which should be set as part of the shortcut to afscreds.exe.  afscreds.exe rewrites the shortcut each time it exits so as to ensure that the shortcut points to the latest version of the program.  This value is used to determine which values should be used for command line parameters.  The current user value is checked first; if it does not exist the local machine value is checked.

The following subset of the command line options is appropriate for use in this registry setting:

-A = autoinit
-M = renew drive maps
-N = ip address change detection
-Q = quiet mode.  do not display start service dialog if afsd_service is not already running
-S = show tokens dialog on startup
-Z = unmap drives

Regkey: [HKCU\SOFTWARE\OpenAFS\Client]

Value: Authentication Cell

Type: REG_SZ

Default: <none>

Function: Afscreds.exe GetDefaultCell()

This value allows the user to configure a different cell name to be used as the default cell when acquiring tokens in afscreds.exe.

Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Reminders]

Value: "afs cell name"

Type: DWORD {0, 1}

Default: <none>

Function: LoadRemind(), SaveRemind()

These values are used to save and restore the state of the reminder flag for each cell for which the user has obtained tokens.

This value used to be stored at [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].

Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]

Value: "upper case drive letter"

Type: DWORD {0, 1}

Default: <none>

These values are used to store the persistence state of the AFS drive mappings as listed in the [...\Client\Mappings] key.

These values used to be stored in the afsdsbmt.ini file

Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Mappings]

Value: "upper case drive letter"

Type: REG_SZ

Default: <none>

These values are used to store the AFS path in UNIX notation to which the drive letter is to be mapped.

These values used to be stored in the afsdsbmt.ini file.