PCShare UB64 User manual (Version 6.0.0)  
 

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

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

advertizedinterfaces
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
<see text>

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.

dirs
int
<see text>

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
str
"%n %p"

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.

Note:

As of Windows Vista, this comment is no longer displayed in Windows Explorer.

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 with the server's scope identifier.

Note:

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

6.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 print job.

exit
str
""

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

cr
str
""

Specifies whether CR (carriage return) characters are converted to CRLF (carriage return/line feed). Possible strings are: cr, lf, crlf, lfcr, none

lf
str
""

Specifies whether LF (line feed) characters are converted to CRLF (carriage return/line feed). Possible strings are: cr, lf, crlf, lfcr, none

postscript
bool
TRUE

Specifies if PostScript jobs should be resolved.

6.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 © 2015 HELIOS Software GmbH  
HELIOS Manuals June 28, 2016