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 Base manual.
Important: 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.
(Requires a restart of the service (see " srvutil" in the Base manual) to take effect.)
Key: Programs/pcshare/<preference>
Type Default (""=empty string)
Specifies the number of " 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 10*sessions, where " sessions" is equal to the number of units (clients) for which you bought your license.
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 editing.
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.)
str "
smb://<ip-number>
/?NAME=<hostname>"
Specifies the SLP (
Service Location Protocol) URL of the PCShare server that is to be registered.
While logging on to the SLP server, each process sends along a " lifetime" value (in seconds). At intervals, the SLP server verifies that each service is still running. If so, it renews the lifetime. Otherwise, the SLP server removes the process registration from its list.
This preference contains the scopes which this server uses for SLP registrations.
Important: If a Directory Agent is active and a Service Agent uses a scope that is NOT supported by a Directory Agent, its registrations are not available.
This preference specifies the maximum number of files that can be opened by the file server simultaneously. The achievable maximum cannot exceed the maximum number of open files per process currently allowed by the host. It is normally set by " pcshare" for itself automatically. To save system resources, do not set this value higher than necessary.
The default is the maximum number of open files per process currently allowed by the host or 512, whichever is less.
Comment field for the server in the
Network Neighborhood field of the Windows client.
The default is built from the PCShare server version and the machine architecture, e.g.
PCShare 4.0.0 ankh SunOS 2.8 Generic 10.
Specifies the name PCShare uses to register in the SMB domain/workgroup for Windows'
Network Neighborhood.
If set to
TRUE, this parameter 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, 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" .
PCShare clients can optionally be configured for dynamic IP address allocation, rather than manually configuring the address on each client. " HELIOSDIR/var/conf/ethers.pcs" is used in this case to store a list of client IP addresses which have been automatically allocated. Dynamically allocated IP addresses will be reused by the server for other clients if they are not used by the original client for dynage days.
The default for
dynage is 62 (days). If
dynage=0, the server never reuses IP addresses which have been dynamically allocated.
For more information see
gateways below.
strlist (e.g.: "172.16.0.1",
"172.16.1.1")
PCShare clients can be optionally configured for dynamic IP address allocation, rather than manually configuring the address on each PC. This preference specifies the name(s) and/or IP address(es) of one or more IP routers on the network (if any).
PCShare clients configured for dynamic IP address allocation are then allocated to the gateway in this list which is appropriate to their IP address. The gateways list has the same function as the " gateway" entry in the local HOSTS file, which is not present if the client is configured for dynamic IP address allocation.
Specifies the time interval (in seconds) in which a
secondary boot server synchronizes the data with the
primary boot server. At each client boot request this synchronization is intended to be carried out if at least
primaryage time has passed after the last synchronization.
Has the same effect as
primaryage (see above), but takes effect only if the
primary boot server fails.
Specifies if DHCP static " Ethernet-to-IP address" mappings, which are defined in " /etc/bootptab" or
" /etc/ethers" , are used too.
Specifies if an error message is written to the " syslog" file when the " Ethernet-to-IP address" mapping is missing at BOOTP protocol requests.
Forms the list of one or more IP addresses of the servers which can be used. It is transferred to the client via DHCP. By default, the server uses the information from the local
" /etc/resolv.conf" file.
Template which is used to add a new IP address to the " nsupdate" program. The default is:
update add %h.%d. %t in a %a
update add %r.in-addr.arpa. %t in ptr %h.%d.
The " % escapes" are replaced as follows:
%h Host Name
%d DNS Update Domain
%a IP Address
%r Reverse IP Address
%t DNS TTL
For more information on " nsupdate" see the respective UNIX manual pages.
Template which is used to delete IP addresses to the " nsupdate" program. The default is:
update delete %h.%d. in a
update delete %r.in-addr.arpa. in ptr
The " %escapes" are the same as those described in
dnsadd.
Stops the " nsupdate" program if it has been idling for the specified amount of time (in seconds). If necessary, it is started again.
Time (in seconds) how long a DNS entry is allowed to remain in the cache.
Program which is used for dynamic DNS updates. This is part of the UNIX-named DNS bind daemon packets. The program is called in a pipe and controlled by the
dnsadd and
dnsdel templates.
Specifies the DHCP lease time (in sec.) for an IP address.
Specifies the IP address of the primary WINS server.
Has the same effect as
nameserver (see above), but only takes effect if the primary name server fails.
Specifies the IP addresse(s) of those syslog servers which are to be given to DHCP clients. More than one IP address can be specified by comma-separation.
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.
Specifies if PCShare simulates a
Primary Domain Controller.
This preference is normally not set. If the Windows PC is configured to use a scope identifier it needs to be identical to the Windows client configuration.
Specifies if PCShare attempts to become LMB.
6.2 " pcfilter" preferences
Key: Printers/<printer>/pcfilter/<preference>
If set to
TRUE, this flag filters out " Ctrl-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 PostScript print job.
Specifies the byte sequence at the end of a PostScript print job.
Specifies whether CR (
carriage return) characters are converted to CRLF (
carriage return/line feed).
Specifies if LF (
line feed) characters are converted to CRLF (
carriage return/line feed).
Specifies if PostScript jobs to a
TCP,
Remote LPR,
Print To Disk, or
Windows printer queue are 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.
(HELIOS Admin option
PostScript Printer)
If a file is sent to a
TCP, Remote LPR, Print To Disk, or Windows printer queue, with this option set to
FALSE,
the print job remains " untouched" and is passed on without any changes. For this preference, the key must be extended to "
Printers/<printer queue>/pcfilter/postscript" .
