HP CIFS Client A.02.02.03 Administrator's Guide

7 Configuration File
The default configuration file should work without modifications. Please be sure you understand
the effects of any changes before you decide to modify the configuration file.
The configuration file is parsed by the HP CIFS Client daemon at startup and when edited. Although
it is re-read by the running daemon, not all configuration changes will work immediately. Most
options are read into internal variables when they are used. The server configuration, for instance,
is transferred into internal structures when a connection to the server is opened. Therefore, if a
change to the server configuration is made, you must first unmount all shares and log out all users
from that server. The configuration file for the HP CIFS Client is
/etc/opt/cifsclient/cifsclient.cfg.
NOTE: The CIFS Client configuration file, cifsclient.cfg, used for HP CIFS Client A.01.*
is not valid for HP CIFS Client A.02.*. For detailed information on how to update any A.01.*
version to any A.02.* version of the CIFS Client, see “Migrating from version A.01.* to A.02.*
of HP CIFS Client” (page 28) in Chapter 4.
General Structure
Configuration files are built from the following simple syntactic structures:
• comments
• strings
• arrays
• dictionaries
The # character starts a comment; any text between a # character and the end of a line is a
comment.
# comment to end of line
Strings, arrays and dictionaries are classified by the generic term "property".
Strings are sequences of alphanumeric characters, including the underscore. If a string should
consist of other characters like spaces, it must be quoted in double quotes. Within double quotes,
the same escape sequences as in C strings can be used. There is no separate syntax for numeric
arguments. Numeric arguments are regarded as strings and converted when used.
Arrays are ordered lists of other properties. An array is delimited by parentheses and the properties
constituting the array may be separated by commas. The following example is an array consisting
of several string elements:
(1, 2, 3, hello, "how are you")
Dictionaries are unordered lists of named properties. These lists are delimited by curly braces.
Each dictionary entry consists of a left -hand side (key), which must be a string, an equal sign, and
a right -hand side (value) which may be any property. Entries may be separated by semicolons.
The following is an example of a dictionary consisting of three entries named property1 to property3;
where the first one has a string value, the second an array value, and the third a dictionary value:
{
property1 = "value of property1";
property2 = (value, of, property2);
property3 = {
firstWord = value;
secondWord = of;
thirdWord = property3;
};
}
General Structure 47