[go: up one dir, main page]

File: fusesmb.conf.5

package info (click to toggle)
fusesmb 0.8.7-1.3
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 592 kB
  • ctags: 254
  • sloc: sh: 3,185; ansic: 2,912; makefile: 67
file content (124 lines) | stat: -rw-r--r-- 3,975 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
.TH FUSESMB.CONF 5 "August 5, 2005"

.SH NAME
fusesmb.conf \- the configuration file for \fBfusesmb\fR

.SH 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: \fIname\fR = \fIvalue\fR.

The file is line-based \- that is, each newline\-terminated line represents either a comment, a section name or a parameter.
.PP
Section and parameter names are not case sensitive.
.PP
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.
.PP
Any  line beginning with a semicolon (``\fB;\fR'') or a hash (``\fB#\fR'') character is ignored, as are lines containing only whitespace.

.SH SPECIAL SECTIONS
.B fusesmb.conf
can contain the following sections:
.TP
The \fB[global]\fR section
Section for global parameters.
.TP
The \fB[ignore]\fR section
Section for specifying servers and/or workgroups that should not be listed.
.TP
The \fB[/\fISERVER\fR\fB]\fR section
Section for server-specific settings. The section name should start with a slash ``\fB/\fR'' and not end with a slash.
.TP
The \fB[/\fISERVER\fB/\fISHARE\fB]\fR
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.

.SH 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].
.TP
\fBignore\fR ( [/SERVER] )
Ignore this server. Possible values are: true, false, 1 and 0.

Example: \fIignore\fR = \fItrue\fR
.TP
\fBinterval\fR ( [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: \fIinterval\fR = \fI20\fR
.TP
\fBpassword\fR ( [global], [/SERVER], [/SERVER/SHARE] )
Password. Value is string containing the password.

Example: \fIpassword\fR = \fIsecret\fR
.TP
\fBservers\fR ( [ignore] )
Servers to ignore. Value is each server to ignore separated by a comma.

Example: \fIservers\fR = \fISERVER1, SERVER2, SERVER3\fR

.TP
\fBshowhiddenshares\fR ( [global], [/SERVER] )
Show hidden shares. Possible values are: true, false, 1 and 0.

Example: \fIshowhiddenshares\fR = \fIfalse\fR

.TP
\fBtimeout\fR ( [global] )
Connection timeout in seconds. A server after this timeout is considered offline. Values smaller than 2 seconds are ignored.

Example: \fItimeout\fR = \fI10\fR

.TP
\fBusername\fR ( [global], [/SERVER], [/SERVER/SHARE] )
Username. Value is string containing the username.

Example: \fIusername\fR = \fIjohndoe\fR

.TP
\fBworkgroups\fR ( [ignore] )
Workgroups to ignore. Value is each workgroup to ignore separated by a comma.

Example: \fIworkgroups\fR = \fIWORKGROUP1, WORKGROUP2\fR


.SH EXAMPLE
.nf
; Global settings
.B [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
.B [ignore]
servers=SERVER,SERVER2,SERVER3
workgroups=WORKGROUP,WG2

; Share-specific settings
.B [/SERVER/SHARE]
username=john
password=doe

; Server-specific settings
.B [/SERVER]
username=jane
password=doe
showhiddenshares=true
ignore=true
.fi

.SH "SEE ALSO"
.BR fusesmb (1)

.SH AUTHOR
Vincent Wagelaar <vincent@ricardis.tudelft.nl>.