This chapter lists all the preferences that are pertinent to PCShare. Find a description of how to set, view, change or delete preferences, with the HELIOS utility programs “prefdump”, “prefvalue”, and “prefrestore”, in the HELIOS Base manual.
Make sure that preference keys DO NOT start or end with a slash (“/”) character, and note that they are case-sensitive! Also, if any preference key or preference value includes spaces, that key or value must be enclosed in quotes.
Key: Programs/pcshare/<preference>
Specifies the number of “file and region locks” that the server allows simultaneously (if EtherShare is installed on the same server it must be allocated the same settings).
The default for this parameter is sessions*(files+20), where
“sessions” is equal to the number of units (clients) for which you bought your
license and “files” is the maximum number of of files (see files
preference).
Do not set this preference to an unnecessary high value because this increases PCShare’s requirement for UNIX system resources.
If set to FALSE, an “older” protocol version compatibility
mode is activated, for e.g. Windows 9x, but not NT.
Offers Windows clients to use Unicode based file names.
Files which are accessed from the file server are locally cached. This brings a significant speed up to file access.
Specifies the IP address the “pcshare” program offers to the SMB clients for logging in via IP-protocol. (If this value remains unspecified, i.e. empty, all IP addresses on all network interfaces are offered.)
This preference specifies the maximum number of files that can be opened by one file server process simultaneously. The achievable maximum cannot exceed the maximum number of open files per process currently allowed by the host. To save system resources, do not set this value larger than set by the “ulimit” UNIX command.
The default value for this preference is 8192, and 2048 on OS X platforms.
Specifies the number of shared memory slots that are used to synchronize changes between PCShare and AFP server. This becomes necessary if the content of a directory changes (by creating or deleting a file) and the other service (“afpsrv” or “pcshare”) must be informed of that change in order to read in the directory anew, and to display the updated content correctly.
Each directory has a hash value that refers to one of the slots.
Large values for this preference have the advantage that different directories very rarely refer to the same slot. If different directories referred to the same slot (A, B, C and D refer to slot 123) changing C would cause A, B, C and D to be read in anew. The only drawback is a higher memory consumption (RAM) in the shared memory. However, each entry (slot) only uses 4 bytes and is valid for all clients – why it is only used once.
Small values lead to unnecessary directory read ins while consuming insignificantly less memory (RAM).
The default value is 16384 (16*1024). It should be raised if the directory usage of all used volumes (sum over all directories in use) exceeds about 1/4 of the current value.
Comment field for the server in the Network Neighborhood
field of the Windows client.
The default is built from the machine name and the PCShare server version,
e.g. sun4100 PCShare 6.0.
As of Windows Vista, this comment is no longer displayed in Windows Explorer.
Specifies the number of entries per directory that should be held in the tunnel cache.
A reasonable default value is 16.
Background: The cache holds the creation date and ensures that long/short file names are retained after renaming or deletion. You could try to set this preference if you experience problems upon saving documents from applications that depend on the older MS-DOS behavior.
For more information see the Windows NT Contains File System Tunneling Capabilities document.
Specifies the time in seconds before a cache entry expires.
Specifies the name PCShare uses to register in the SMB
domain/workgroup for the Windows Network Neighborhood.
If set to TRUE, this preference lets “pcshare” append a record
to the system messages if, due to the IP access list, access
to one or more users has been denied.
If set to TRUE, this preference makes PCShare also log
guest user logins who have mounted control shares (“IPC$”).
Specifies the port number of the Telnet service port where NBS and status information can be queried (see 4.2.4 “Querying PCShare for WINS & Configuration information”).
If set to TRUE, access to the PCShare service port (2003) is
enabled to remote users (subject to the restrictions in the
ipaccess list). The default is that access to the PCShare
service port is only enabled for users on the same host.
Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to “pcshare”.
Specifies if DHCP static “Ethernet-to-IP address” mappings, which are defined in “/etc/bootptab” or “/etc/ethers”, are used too.
Specifies the IP address of the primary WINS server.
Has the same effect as nameserverbackup (see above), but only takes effect if the primary name server fails.
Specifies whether the built-in WINS server is switched on.
Specifies whether saving the WINS data to file is switched off.
If specified, broadcasting nodes can see WINS clients on other subnets but may get confused due to the increased name resolution network traffic.
Can only be used in conjunction with the enableproxy preference. It helps to avoid duplicate computer names. Duplicate computer names in one network will not work reliably.
Specifies the name of the SMB domain/workgroup in which PCShare is registered.
If set to TRUE, PCShare simulates a Primary Domain Controller.
Specifies if PCShare attempts to become LMB.
This preference is usually not set. If the Windows PC is configured to use a scope identifier it needs to be identical with the server's scope identifier.
This preference is also used by the DHCP server, which is part of the HELIOS Base software.
Key: Printers/<printer>/pcfilter/<preference>
If set to TRUE, this flag filters out “CtrlD-D” characters which
are used to indicate “end-of-print-job”, and prefixes each job with “%!PS”.
Adds a “form feed” character to the last page of the print job.
Specifies the file name of the input character set mapping table.
Specifies the file name of the output character set mapping table.
Specifies the byte sequence at the start of a print job.
Specifies the byte sequence at the end of a print job.
Specifies whether CR (carriage return) characters are converted to CRLF (carriage return/line feed). Possible strings are: cr, lf, crlf, lfcr, none
Specifies whether LF (line feed) characters are converted to CRLF (carriage return/line feed). Possible strings are: cr, lf, crlf, lfcr, none
Specifies if PostScript jobs should be resolved.
Key: Printers/<printer>/<preference>
(HELIOS Admin option Computer Name)
Specifies the Windows name (or the IP address/host name) of the PC which the printer is connected to.
(HELIOS Admin option User Name)
Specifies the name of the user who has shared the printer.
(HELIOS Admin option Password)
Specifies the (encrypted) user password.
(HELIOS Admin option Printer Name)
Specifies the name under which the printer is shared on the network.
(HELIOS Admin option PostScript Printer)
If a file is sent to a Windows printer queue, with this option
set to FALSE, the print job remains “untouched” and is
passed on without any changes.