fusesmb.conf5

File format

The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form: name = value.

The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.

Section and parameter names are not case sensitive.

Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.

Any line beginning with a semicolon (``;'') or a hash (``#'') character is ignored, as are lines containing only whitespace.

Special sections

fusesmb.conf can contain the following sections:

The [global] section

Section for global parameters.

The [ignore] section

Section for specifying servers and/or workgroups that should not be listed.

The [/SERVER] section

Section for server-specific settings. The section name should start with a slash ``/'' and not end with a slash.

The [/SERVER/SHARE]

Section for share-specific settings. The section name should start with a slash followed by the server name followed by a slash ending on the share name. It should not end with a slash.

Explanation of each parameter

This chapter explains each possible option. The section names - specified between parentheses after each option - shows the applicable sections for this option. For example: ( [global] ) specifies that this option is only possible for the section [global].

ignore ( [/SERVER] )

Ignore this server. Possible values are: true, false, 1 and 0.

Example: ignore = true

interval ( [global] )

Interval for scanning the network for shares. Value is a number that specifies the network scanning interval in minutes. If the value is smaller or equal to zero the network is not scanned.

Example: interval = 20

password ( [global], [/SERVER], [/SERVER/SHARE] )

Password. Value is string containing the password.

Example: password = secret

servers ( [ignore] )

Servers to ignore. Value is each server to ignore separated by a comma.

Example: servers = SERVER1, SERVER2, SERVER3

showhiddenshares ( [global], [/SERVER] )

Show hidden shares. Possible values are: true, false, 1 and 0.

Example: showhiddenshares = false

timeout ( [global] )

Connection timeout in seconds. A server after this timeout is considered offline. Values smaller than 2 seconds are ignored.

Example: timeout = 10

username ( [global], [/SERVER], [/SERVER/SHARE] )

Username. Value is string containing the username.

Example: username = johndoe

workgroups ( [ignore] )

Workgroups to ignore. Value is each workgroup to ignore separated by a comma.

Example: workgroups = WORKGROUP1, WORKGROUP2

Examples

; Global settings
[global]
; Default username and password
username=user
password=totallysecret
; List hidden shares
showhiddenshares=true
; Connection timeout in seconds
timeout = 10
;Interval for updating new shares in minutes
interval = 10
; Section for servers and/or workgroups to ignore
[ignore]
servers=SERVER,SERVER2,SERVER3
workgroups=WORKGROUP,WG2
; Share-specific settings
[/SERVER/SHARE]
username=john
password=doe
; Server-specific settings
[/SERVER]
username=jane
password=doe
showhiddenshares=true
ignore=true