 |
 |
 |
 |
 |
HELIOS PCShare 3.1 User manual
|
6.1 PCShare preference keys
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 chapter "HELIOS utility programs" of the HELIOS Base manual.
Type Default (""=empty string)
Important: Make sure that preference keys MUST NOT start or end with a slash ("/") character!
6.1.1 PCShare preferences
Key: Programs/pcshare/<preference>
Specifies the number of "region locks" that the server allows simultaneously.
The default value for
locks is ten times the number of sessions allowed by your software license.
Do not set this preference to an unnecessarily high value because this would increase HELIOS Services' requirement for UNIX system resources.
If set to
FALSE, this preference activates an "older" protocol version compatibility mode, for e.g. Windows 9.x, but not NT.
This preference specifies if print job titles appear correctly in the print queue monitor on different client platforms. If set to
TRUE, the single character set is used and Umlauts and other special characters cannot be represented correctly. The
Smart print job title option in PCShare Admin's
Printer Preferences configuration window corresponds inversely to this preference, i.e. if
singlecharset is set to
FALSE, the
Smart print job title option is enabled.
str "
smb://<ip-number>
/?NAME=<hostname>"
Specifies the SLP (
Service Location Protocol) URL of the PCShare Server that is to be registered.
Specifies a list, separated by commas, which comprises the defined SLP-zones on the server.
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 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 conserve 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 256, whichever is less.
Specifies the user name which is automatically allocated to guest users. The name is invisible to the guest users themselves, it is solely used to assign an entry for guests in the user list.
The default for guest is "nobody". The specified guest user must exist on your host. The PCShare installation automatically creates the user "nobody" if it does not already exist.
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 3.1.0 lux SunOS 2.8 Generic 10. For a description of the format specifiers see PCShare Admin's
Comment field (
Browsing Setup menu) in
3.3.3 "Browsing".
Specifies the name PCShare uses to register in the SMB domain/workgroup for Windows'
Network Neighborhood.
Lets "PCShare" append a record to the system messages file if, due to the IP access list, access from one or more clients has been denied.
Specifies the time interval in seconds after which the UNIX user and group database is checked for changes.
PCShare clients can be optionally configured for dynamic IP address allocation, rather than manually configuring the address on each PC. In this case, "HELIOSDIR/var/conf/ethers.pcs" is used 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.
str (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 via 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 below), but takes only effect if the primary name server fails.
Specifies the IP addresse(s) of those syslog servers which are to be given to DHCP clients.
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.1.2 Volume preference keys
Note: Changes only take effect if the volume is mounted anew.
Key: Volumes/<UNIX path>/<preference>
Sets the PCShare SMB volume name. The setting reflects that of the
Volume Name: field
in PCShare Admin's
Export Volumes configuration window.
This flag must be set to
TRUE when the underlying physical media is write protected (e.g. CD-ROM). Then, there is
- for all users - only read access to the specific volume. The setting reflects that of the checkbox
Read only in PCShare Admin's
Export Volumes configuration window.
This flag specifies how the server handles cross-platform record locking between clients and UNIX applications.
This flag specifies how the server handles cross-platform file locking between clients and UNIX applications.
With this flag set to
TRUE, the particular volume is published for PCShare clients. The setting reflects that of the checkbox
SMB Visible in PCShare Admin's
Export Volumes configuration window.
With this flag set to
TRUE, guest access is allowed on the particular volume. The setting reflects that of the checkbox
Guest Access in EtherShare Admin's
Volumes: configuration window.
This flag makes the host use the Unicode character set encoding on the specific volume. This provides a correct cross-platform file name display (particularly if the names contain special characters, such as "umlauts" between Macintosh clients, PC clients, and UNIX servers. The setting reflects that of the checkbox
Unicode/UTF-8 in EtherShare Admin's
Volumes: configuration window.
If this flag is set to
TRUE, all files which names begin with a dot (e.g. ".pcadmin") are sent as "hidden" files to the client, and are displayed only if you have activated the
Show hidden files and folders option in Windows'
Folder Options control panel at the client side.. The setting reflects that of the checkbox
Hide `dot' files in PCShare Admin's
Export Volumes configuration window.
Specifies how the file server reacts to a file close command from a PCShare client.
Close disables the file descriptor caching, so files are closed immediately as soon as the file close command is received. The setting reflects that of the checkbox
Close option in PCShare Admin's
Export Volumes configuration window.
Specifies a list of groups which are allowed access to this particular volume. The setting reflects the entries in the
Groups: field in EtherShare Admin's
Volumes: configuration window, and the PCShare Admin
Export Volumes > Current Groups window.
Specifies the file name of the IP access list that makes the particular volume visible for clients which have one of the IP numbers on the IP access list.
If
UTF8 is set the charset flag is used to translate and encode file names to the "PC850" or "SJIS" character set. The setting reflects that of the
Charset: pop-up menu in PCShare Admin's
Export Volumes configuration window.
Note: This preference can only be set in PCShare Admin when creating a new volume. Changing the character set encoding of an already existing volume via PCShare Admin is not possible.
Specifies how the file server reacts to a directory close command from the PCShare client.
closedirs disables the directory descriptor caching, so directories are closed immediately as soon as the directory close command is received.
Specifies whether or not the server allows record locking between multiple PCShare clients.
This flag specifies how the server reacts if a PCShare client opens a file for reading or writing without indicating how (and whether) the file can be simultaneously opened by other programs. Normally, if a file is opened for reading, other users can only open the file for reading ("deny other write"). Furthermore, if a file is opened for reading and writing, other users cannot open the file at all ("deny other all").
6.1.3 "smbif" preference keys
Key: Printers/<printer queue>/<preference>
Specifies the PCShare export name of the particular printer. It corresponds to
Export Name: in PCShare Admin's
Export Printers: configuration window.
Specifies the path of the UNIX command which is used to issue print jobs.
(EtherShare/PCShare Admin option
Computer Name:)
Specifies the Windows name (or the IP address/host name) of the PC which the printer is connected to.
If a file is sent to a
TCP, Remote LPR, Print To Disk, or Windows printer queue, with this flag set to
FALSE, the print job remains "untouched" and is passed on without any changes.
(EtherShare/PCShare Admin option
User Name:)
Specifies the name of the user who has shared the printer.
(EtherShare/PCShare Admin option
Password:)
Specifies the (encrypted) user password.
(EtherShare Admin option
Printer Name:)
(PCShare Admin option
Queue Name:)
Specifies the name under which the printer is shared.
(EtherShare 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.
6.1.4 "pcfilter" preferences
Key: Printers/<printer>/pcfilter/<preference>
This flag determines whether the "Ctrl-D" character is used to indicate "end-of-print-job", and prefixes each job with "%!PS". This is necessary if the printer is connected to TCP/IP through a terminal server and a serial interface.
Adds a "form feed" character to the last page of the print job. The setting reflects that of the checkbox
Form feed in PCShare Admin's
Export Printers configuration window.
Specifies the file name of the input character set mapping table. The setting reflects that of the
Input Table: field in PCShare Admin's
Export Printers configuration window.
Specifies the file name of the output character set mapping table. The setting reflects that of the
Output Table: field in PCShare Admin's
Export Printers configuration window.
Specifies the byte sequence at the start of a PostScript print job. The setting reflects that of the
Init String: field in PCShare Admin's
Export Printers configuration window.
Specifies the byte sequence at the end of a PostScript print job. The setting reflects that of the
Exit String: field in PCShare Admin's
Export Printers configuration window.
Specifies if CR characters are converted to CRLF (
CRLF), or just stripped (
None).
Specifies if LF characters are converted to CRLF (
CRLF), or just stripped (
None).
6.1.5 Preferences for the Administration
Key: Global/Programs/<preference>
PCShare Admin allows users with sufficient permissions to configure the PCShare system from any PC on the network in a convenient and secure way. For example, it can be used to set up users, groups, volumes, and printers, and inspect or delete print jobs.
Normally, only the system administrator is allowed to make any changes. Non-privileged users can inspect the configuration and the print job queue, but cannot change anything except delete their own print jobs.
However, members of the special "printer administrators" group can also use "PCShare Admin" for print job scheduling (e.g. deleting print jobs) only.
prnadmgroup specifies the name of the special "printer administrators" group.
Compare
sysadmgroup and
queadmgroup.
PCShare Admin allows users with sufficient permissions to configure the PCShare system from any PC on the network in a convenient and secure way. For example, it can be used to set up users, groups, volumes and printers, and inspect or delete print jobs. Normally, only the system administrator is allowed to make any changes. Non-privileged users can inspect the configuration and the print job queue, but cannot change anything except delete their own print jobs.
However, members of the special "system administrators" group can also use "PCShare Admin" to make any changes they like, including printer configuration, but they are not allowed to modify any information on users with an ID less than 100 (note: root has a user ID of 0).
sysadmgroup specifies the name of the special "system administrators" group. Compare
prnadmgroup and
queadmgroup.
Name of group which is allowed to configure and administer PCShare queues (compare
prnadmgroup and
sysadmgroup).
| © 2003 HELIOS Software GmbH |