PCShare UB2 User manual (Version 5.0.0)  
 

5 Preferences

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.

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.

5.1 PCShare preferences

The following keys require a restart (see “srvutil” in the HELIOS Base manual) of the service to take effect:

Key: Programs/pcshare/<preference>

locks
int
(see description)

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.

offerNTCaps
bool
TRUE

If set to FALSE, an “older” protocol version compatibility mode is activated, for e.g. Windows 9x, but not NT.

unicode
bool
TRUE

Offers Windows clients to use Unicode based file names.

oplocks
bool
TRUE

Files which are accessed from the file server are locally cached. This brings a significant speed up to file access.

interfaces
strlist
""

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.)

files
int
2048

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.

comment
str
"%p %n"

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.5.0 ankh SunOS 2.8 Generic 10.

FSTunnelCache
int
0

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.

FSTunnelCacheTimeout
int
15

Specifies the time in seconds before a cache entry expires.

hostname
str
<hostname>

Specifies the name PCShare uses to register in the SMB domain/​workgroup for the Windows Network Neighborhood.

logdenied
bool
FALSE

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.

logNoMount
bool
FALSE

If set to TRUE, this preference makes PCShare also log guest user logins who have mounted control shares (“IPC$”).

telnetport
int
2003

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”).

RemoteAccess
bool
FALSE

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.

ipaccess
str
"var/conf/ipaccess"

Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to “pcshare”.

staticaddresses
bool
TRUE

Specifies if DHCP static “Ethernet-to-IP address” mappings, which are defined in “/​etc/​bootptab” or “/​etc/​ethers”, are used too.

nameserver
str
""

Specifies the IP address of the primary WINS server.

nameserverbackup
str
""

Has the same effect as nameserverbackup (see above), but only takes effect if the primary name server fails.

enablewins
bool
FALSE

Specifies whether the built-in WINS server is switched on.

nowinsbackup
bool
FALSE

Specifies whether saving the WINS data to file is switched off.

enableproxy
bool
FALSE

If specified, broadcasting nodes can see WINS clients on other subnets but may get confused due to the increased name resolution network traffic.

enableproxyregcheck
bool
FALSE

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.

domainname
str
"WORKGROUP">

Specifies the name of the SMB domain/workgroup in which PCShare is registered.

primarydomaincontroller
bool
FALSE

If set to TRUE, PCShare simulates a Primary Domain Controller.

avoidelections
bool
FALSE

Specifies if PCShare attempts to become LMB.

scopeid
str
""

This preference is usually not set. If the Windows PC is configured to use a scope identifier it needs to be identical to the Windows client configuration.

Note:

This preference is also used by the DHCP server, which is part of the HELIOS Base software.

5.2 “pcfilter” preferences

Key: Printers/<printer>/pcfilter/<preference>

ctrld
bool
FALSE

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”.

formfeed
bool
FALSE

Adds a “form feed” character to the last page of the print job.

input
str
""

Specifies the file name of the input character set mapping table.

output
str
""

Specifies the file name of the output character set mapping table.

init
str
""

Specifies the byte sequence at the start of a PostScript print job.

exit
str
""

Specifies the byte sequence at the end of a PostScript print job.

cr
str
""

Specifies whether CR (carriage return) characters are converted to CRLF (carriage return/line feed).

lf
str
""

Specifies whether LF (line feed) characters are converted to CRLF (carriage return/line feed).

postscript
bool
TRUE

Specifies if PostScript jobs to a TCP, Remote LPR, Print To Disk or Windows printer queue are resolved.

5.3 “smbif” preferences

Key: Printers/<printer>/<preference>

SMBPrinterHost
str
""

(HELIOS Admin option Computer Name)

Specifies the Windows name (or the IP address/host name) of the PC which the printer is connected to.

SMBPrinterUser
str
""

(HELIOS Admin option User Name)

Specifies the name of the user who has shared the printer.

SMBPrinterPasswd
str
""

(HELIOS Admin option Password)

Specifies the (encrypted) user password.

SMBPrinterName
str
""

(HELIOS Admin option Printer Name)

Specifies the name under which the printer is shared on the network.

SMBPrinterResolve
bool
TRUE

(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 Website © 2011 HELIOS Software GmbH  
HELIOS Manuals October 6, 2011