1FUSESMB.CONF(5)               File Formats Manual              FUSESMB.CONF(5)
2
3
4

NAME

6       fusesmb.conf - the configuration file for fusesmb
7
8

FILE FORMAT

10       The file consists of sections and parameters. A section begins with the
11       name of the section in square brackets and  continues  until  the  next
12       section begins. Sections contain parameters of the form: name = value.
13
14       The  file  is line-based - that is, each newline-terminated line repre‐
15       sents either a comment, a section name or a parameter.
16
17       Section and parameter names are not case sensitive.
18
19       Only the first equals sign in a parameter  is  significant.  Whitespace
20       before  or after the first equals sign is discarded.  Leading, trailing
21       and internal whitespace in section and parameter names  is  irrelevant.
22       Leading  and   trailing   whitespace in a parameter value is discarded.
23       Internal whitespace within a parameter value is retained verbatim.
24
25       Any  line beginning with a semicolon (``;'') or a hash (``#'')  charac‐
26       ter is ignored, as are lines containing only whitespace.
27
28

SPECIAL SECTIONS

30       fusesmb.conf can contain the following sections:
31
32       The [global] section
33              Section for global parameters.
34
35       The [ignore] section
36              Section for specifying servers and/or workgroups that should not
37              be listed.
38
39       The [/SERVER] section
40              Section for server-specific settings. The  section  name  should
41              start with a slash ``/'' and not end with a slash.
42
43       The [/SERVER/SHARE]
44              Section  for  share-specific  settings.  The section name should
45              start with a slash followed by the server  name  followed  by  a
46              slash ending on the share name. It should not end with a slash.
47
48

EXPLANATION OF EACH PARAMETER

50       This  chapter explains each possible option. The section names - speci‐
51       fied between parentheses after each option - shows the applicable  sec‐
52       tions  for  this  option. For example: ( [global] ) specifies that this
53       option is only possible for the section [global].
54
55       ignore ( [/SERVER] )
56              Ignore this server. Possible values are: true, false, 1 and 0.
57
58              Example: ignore = true
59
60       interval ( [global] )
61              Interval for scanning the network for shares. Value is a  number
62              that  specifies the network scanning interval in minutes. If the
63              value is smaller or equal to zero the network is not scanned.
64
65              Example: interval = 20
66
67       password ( [global], [/SERVER], [/SERVER/SHARE] )
68              Password. Value is string containing the password.
69
70              Example: password = secret
71
72       servers ( [ignore] )
73              Servers to ignore. Value is each server to ignore separated by a
74              comma.
75
76              Example: servers = SERVER1, SERVER2, SERVER3
77
78
79       showhiddenshares ( [global], [/SERVER] )
80              Show hidden shares. Possible values are: true, false, 1 and 0.
81
82              Example: showhiddenshares = false
83
84
85       timeout ( [global] )
86              Connection  timeout  in  seconds. A server after this timeout is
87              considered offline. Values smaller than 2 seconds are ignored.
88
89              Example: timeout = 10
90
91
92       username ( [global], [/SERVER], [/SERVER/SHARE] )
93              Username. Value is string containing the username.
94
95              Example: username = johndoe
96
97
98       workgroups ( [ignore] )
99              Workgroups to ignore. Value is each workgroup  to  ignore  sepa‐
100              rated by a comma.
101
102              Example: workgroups = WORKGROUP1, WORKGROUP2
103
104
105

EXAMPLE

107       ; Global settings
108       [global]
109
110       ; Default username and password
111       username=user
112       password=totallysecret
113
114       ; List hidden shares
115       showhiddenshares=true
116
117       ; Connection timeout in seconds
118       timeout = 10
119
120       ;Interval for updating new shares in minutes
121       interval = 10
122
123       ; Section for servers and/or workgroups to ignore
124       [ignore]
125       servers=SERVER,SERVER2,SERVER3
126       workgroups=WORKGROUP,WG2
127
128       ; Share-specific settings
129       [/SERVER/SHARE]
130       username=john
131       password=doe
132
133       ; Server-specific settings
134       [/SERVER]
135       username=jane
136       password=doe
137       showhiddenshares=true
138       ignore=true
139
140

SEE ALSO

142       fusesmb(1)
143
144

AUTHOR

146       Vincent Wagelaar <vincent@ricardis.tudelft.nl>.
147
148
149
150                                August 5, 2005                 FUSESMB.CONF(5)