← Back to branch summary

~ubuntu-branches/ubuntu/maverick/samba/maverick-security

« back to all changes in this revision

Viewing changes to .pc/fix-manpages-warnings.patch/docs/manpages/smbcontrol.1

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2010-01-29 06:16:15 UTC
  • mfrom: (0.27.9 upstream) (0.34.4 squeeze)
  • Revision ID: james.westby@ubuntu.com-20100129061615-37hs6xqpsdhjq3ld
Tags: 2:3.4.5~dfsg-1ubuntu1
https://launchpad.net/bugs/462169
https://launchpad.net/bugs/493565
* Merge from debian testing.  Remaining changes:
  + debian/patches/VERSION.patch:
    - set SAMBA_VERSION_SUFFIX to Ubuntu.
  + debian/smb.conf:
    - Add "(Samba, Ubuntu)" to server string.
    - Comment out the default [homes] share, and add a comment about "valid users = %s"
      to show users how to restrict access to \\server\username to only username.
    - Set 'usershare allow guests', so that usershare admins are allowed to create
      public shares in additon to authenticated ones.
    - add map to guest = Bad user, maps bad username to gues access.
  + debian/samba-common.conf:
    - Do not change priority to high if dhclient3 is installed.
    - Use priority medium instead of high for the workgroup question.
  + debian/mksambapasswd.awk:
    - Do not add user with UID less than 1000 to smbpasswd.
  + debian/control: 
    - Make libswbclient0 replace/conflict with hardy's likewise-open.
    - Don't build against ctdb, since its not in main yet.
  + debian/rules:
    - Enable "native" PIE hardening.
    - Add BIND_NOW to maximize benefit of RELRO hardening.
  + Add ufw integration:
    - Created debian/samba.ufw.profile.
    - debian/rules, debian/samba.dirs, debian/samba.files: install
  + Add apoort hook:
    - Created debian/source_samba.py.
    - debian/rules, debian/samba.dirs, debian/samba-common-bin.files: install
  + debian/rules, debian/samba.if-up: allow "NetworkManager" as a recognized address
    family... it's obviously /not/ an address family, but it's what gets
    sent when using NM, so we'll cope for now.  (LP: #462169). Taken from karmic-proposed.
  + debian/control: Recommend keyutils for smbfs (LP: #493565)
  + Dropped patches:
    - debian/patches/security-CVE-2009-3297.patch: No longer needed
    - debian/patches/fix-too-many-open-files.patch: No longer needed

Show diffs side-by-side

added added

removed removed

Lines of Context:
.pc/fix-manpages-warnings.patch/docs/manpages/smbcontrol.1
1
 
.\"     Title: smbcontrol
2
 
.\"    Author: [see the "AUTHOR" section]
3
 
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
4
 
.\"      Date: 10/29/2009
5
 
.\"    Manual: User Commands
6
 
.\"    Source: Samba 3.4
7
 
.\"  Language: English
8
 
.\"
9
 
.TH "SMBCONTROL" "1" "10/29/2009" "Samba 3\&.4" "User Commands"
10
 
.\" -----------------------------------------------------------------
11
 
.\" * (re)Define some macros
12
 
.\" -----------------------------------------------------------------
13
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14
 
.\" toupper - uppercase a string (locale-aware)
15
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
16
 
.de toupper
17
 
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
18
 
\\$*
19
 
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
20
 
..
21
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22
 
.\" SH-xref - format a cross-reference to an SH section
23
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
24
 
.de SH-xref
25
 
.ie n \{\
26
 
.\}
27
 
.toupper \\$*
28
 
.el \{\
29
 
\\$*
30
 
.\}
31
 
..
32
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33
 
.\" SH - level-one heading that works better for non-TTY output
34
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
35
 
.de1 SH
36
 
.\" put an extra blank line of space above the head in non-TTY output
37
 
.if t \{\
38
 
.sp 1
39
 
.\}
40
 
.sp \\n[PD]u
41
 
.nr an-level 1
42
 
.set-an-margin
43
 
.nr an-prevailing-indent \\n[IN]
44
 
.fi
45
 
.in \\n[an-margin]u
46
 
.ti 0
47
 
.HTML-TAG ".NH \\n[an-level]"
48
 
.it 1 an-trap
49
 
.nr an-no-space-flag 1
50
 
.nr an-break-flag 1
51
 
\." make the size of the head bigger
52
 
.ps +3
53
 
.ft B
54
 
.ne (2v + 1u)
55
 
.ie n \{\
56
 
.\" if n (TTY output), use uppercase
57
 
.toupper \\$*
58
 
.\}
59
 
.el \{\
60
 
.nr an-break-flag 0
61
 
.\" if not n (not TTY), use normal case (not uppercase)
62
 
\\$1
63
 
.in \\n[an-margin]u
64
 
.ti 0
65
 
.\" if not n (not TTY), put a border/line under subheading
66
 
.sp -.6
67
 
\l'\n(.lu'
68
 
.\}
69
 
..
70
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71
 
.\" SS - level-two heading that works better for non-TTY output
72
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
73
 
.de1 SS
74
 
.sp \\n[PD]u
75
 
.nr an-level 1
76
 
.set-an-margin
77
 
.nr an-prevailing-indent \\n[IN]
78
 
.fi
79
 
.in \\n[IN]u
80
 
.ti \\n[SN]u
81
 
.it 1 an-trap
82
 
.nr an-no-space-flag 1
83
 
.nr an-break-flag 1
84
 
.ps \\n[PS-SS]u
85
 
\." make the size of the head bigger
86
 
.ps +2
87
 
.ft B
88
 
.ne (2v + 1u)
89
 
.if \\n[.$] \&\\$*
90
 
..
91
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92
 
.\" BB/BE - put background/screen (filled box) around block of text
93
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
94
 
.de BB
95
 
.if t \{\
96
 
.sp -.5
97
 
.br
98
 
.in +2n
99
 
.ll -2n
100
 
.gcolor red
101
 
.di BX
102
 
.\}
103
 
..
104
 
.de EB
105
 
.if t \{\
106
 
.if "\\$2"adjust-for-leading-newline" \{\
107
 
.sp -1
108
 
.\}
109
 
.br
110
 
.di
111
 
.in
112
 
.ll
113
 
.gcolor
114
 
.nr BW \\n(.lu-\\n(.i
115
 
.nr BH \\n(dn+.5v
116
 
.ne \\n(BHu+.5v
117
 
.ie "\\$2"adjust-for-leading-newline" \{\
118
 
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
119
 
.\}
120
 
.el \{\
121
 
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
122
 
.\}
123
 
.in 0
124
 
.sp -.5v
125
 
.nf
126
 
.BX
127
 
.in
128
 
.sp .5v
129
 
.fi
130
 
.\}
131
 
..
132
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133
 
.\" BM/EM - put colored marker in margin next to block of text
134
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
135
 
.de BM
136
 
.if t \{\
137
 
.br
138
 
.ll -2n
139
 
.gcolor red
140
 
.di BX
141
 
.\}
142
 
..
143
 
.de EM
144
 
.if t \{\
145
 
.br
146
 
.di
147
 
.ll
148
 
.gcolor
149
 
.nr BH \\n(dn
150
 
.ne \\n(BHu
151
 
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
152
 
.in 0
153
 
.nf
154
 
.BX
155
 
.in
156
 
.fi
157
 
.\}
158
 
..
159
 
.\" -----------------------------------------------------------------
160
 
.\" * set default formatting
161
 
.\" -----------------------------------------------------------------
162
 
.\" disable hyphenation
163
 
.nh
164
 
.\" disable justification (adjust text to left margin only)
165
 
.ad l
166
 
.\" -----------------------------------------------------------------
167
 
.\" * MAIN CONTENT STARTS HERE *
168
 
.\" -----------------------------------------------------------------
169
 
.SH "Name"
170
 
smbcontrol \- send messages to smbd, nmbd or winbindd processes
171
 
.SH "Synopsis"
172
 
.fam C
173
 
.HP \w'\ 'u
174
 
\FCsmbcontrol\F[] [\-i] [\-s]
175
 
.fam
176
 
.fam C
177
 
.HP \w'\ 'u
178
 
\FCsmbcontrol\F[] [destination] [message\-type] [parameter]
179
 
.fam
180
 
.SH "DESCRIPTION"
181
 
.PP
182
 
This tool is part of the
183
 
\fBsamba\fR(7)
184
 
suite\&.
185
 
.PP
186
 
\FCsmbcontrol\F[]
187
 
is a very small program, which sends messages to a
188
 
\fBsmbd\fR(8), a
189
 
\fBnmbd\fR(8), or a
190
 
\fBwinbindd\fR(8)
191
 
daemon running on the system\&.
192
 
.SH "OPTIONS"
193
 
.PP
194
 
\-h|\-\-help
195
 
.RS 4
196
 
Print a summary of command line options\&.
197
 
.RE
198
 
.PP
199
 
\-s <configuration file>
200
 
.RS 4
201
 
The file specified contains the configuration details required by the server\&. The information in this file includes server\-specific information such as what printcap file to use, as well as descriptions of all the services that the server is to provide\&. See
202
 
\FCsmb\&.conf\F[]
203
 
for more information\&. The default configuration file name is determined at compile time\&.
204
 
.RE
205
 
.PP
206
 
\-i
207
 
.RS 4
208
 
Run interactively\&. Individual commands of the form destination message\-type parameters can be entered on STDIN\&. An empty command line or a "q" will quit the program\&.
209
 
.RE
210
 
.PP
211
 
destination
212
 
.RS 4
213
 
One of
214
 
\fInmbd\fR,
215
 
\fIsmbd\fR
216
 
or a process ID\&.
217
 
.sp
218
 
The
219
 
\fIall\fR
220
 
destination causes the message to "broadcast" to all running daemons including nmbd and winbind\&. This is a change for Samba 3\&.3, prior to this the parameter smbd used to do this\&.
221
 
.sp
222
 
The
223
 
\fIsmbd\fR
224
 
destination causes the message to be sent to the smbd daemon specified in the
225
 
\FCsmbd\&.pid\F[]
226
 
file\&.
227
 
.sp
228
 
The
229
 
\fInmbd\fR
230
 
destination causes the message to be sent to the nmbd daemon specified in the
231
 
\FCnmbd\&.pid\F[]
232
 
file\&.
233
 
.sp
234
 
The
235
 
\fIwinbindd\fR
236
 
destination causes the message to be sent to the winbind daemon specified in the
237
 
\FCwinbindd\&.pid\F[]
238
 
file\&.
239
 
.sp
240
 
If a single process ID is given, the message is sent to only that process\&.
241
 
.RE
242
 
.PP
243
 
message\-type
244
 
.RS 4
245
 
Type of message to send\&. See the section
246
 
\fBMESSAGE\-TYPES\fR
247
 
for details\&.
248
 
.RE
249
 
.PP
250
 
parameters
251
 
.RS 4
252
 
any parameters required for the message\-type
253
 
.RE
254
 
.SH "MESSAGE-TYPES"
255
 
.PP
256
 
Available message types are:
257
 
.PP
258
 
close\-share
259
 
.RS 4
260
 
Order smbd to close the client connections to the named share\&. Note that this doesn\'t affect client connections to any other shares\&. This message\-type takes an argument of the share name for which client connections will be closed, or the "*" character which will close all currently open shares\&. This may be useful if you made changes to the access controls on the share\&. This message can only be sent to
261
 
\fBsmbd\fR\&.
262
 
.RE
263
 
.PP
264
 
debug
265
 
.RS 4
266
 
Set debug level to the value specified by the parameter\&. This can be sent to any of the destinations\&.
267
 
.RE
268
 
.PP
269
 
force\-election
270
 
.RS 4
271
 
This message causes the
272
 
\FCnmbd\F[]
273
 
daemon to force a new browse master election\&.
274
 
.RE
275
 
.PP
276
 
ping
277
 
.RS 4
278
 
Send specified number of "ping" messages and wait for the same number of reply "pong" messages\&. This can be sent to any of the destinations\&.
279
 
.RE
280
 
.PP
281
 
profile
282
 
.RS 4
283
 
Change profile settings of a daemon, based on the parameter\&. The parameter can be "on" to turn on profile stats collection, "off" to turn off profile stats collection, "count" to enable only collection of count stats (time stats are disabled), and "flush" to zero the current profile stats\&. This can be sent to any smbd or nmbd destinations\&.
284
 
.RE
285
 
.PP
286
 
debuglevel
287
 
.RS 4
288
 
Request debuglevel of a certain daemon and write it to stdout\&. This can be sent to any of the destinations\&.
289
 
.RE
290
 
.PP
291
 
profilelevel
292
 
.RS 4
293
 
Request profilelevel of a certain daemon and write it to stdout\&. This can be sent to any smbd or nmbd destinations\&.
294
 
.RE
295
 
.PP
296
 
printnotify
297
 
.RS 4
298
 
Order smbd to send a printer notify message to any Windows NT clients connected to a printer\&. This message\-type takes the following arguments:
299
 
.PP
300
 
queuepause printername
301
 
.RS 4
302
 
Send a queue pause change notify message to the printer specified\&.
303
 
.RE
304
 
.PP
305
 
queueresume printername
306
 
.RS 4
307
 
Send a queue resume change notify message for the printer specified\&.
308
 
.RE
309
 
.PP
310
 
jobpause printername unixjobid
311
 
.RS 4
312
 
Send a job pause change notify message for the printer and unix jobid specified\&.
313
 
.RE
314
 
.PP
315
 
jobresume printername unixjobid
316
 
.RS 4
317
 
Send a job resume change notify message for the printer and unix jobid specified\&.
318
 
.RE
319
 
.PP
320
 
jobdelete printername unixjobid
321
 
.RS 4
322
 
Send a job delete change notify message for the printer and unix jobid specified\&.
323
 
.RE
324
 
.sp
325
 
Note that this message only sends notification that an event has occured\&. It doesn\'t actually cause the event to happen\&.
326
 
.sp
327
 
This message can only be sent to
328
 
\fBsmbd\fR\&.
329
 
.RE
330
 
.PP
331
 
samsync
332
 
.RS 4
333
 
Order smbd to synchronise sam database from PDC (being BDC)\&. Can only be sent to
334
 
\fBsmbd\fR\&.
335
 
.if n \{\
336
 
.sp
337
 
.\}
338
 
.RS 4
339
 
.BM yellow
340
 
.it 1 an-trap
341
 
.nr an-no-space-flag 1
342
 
.nr an-break-flag 1
343
 
.br
344
 
.ps +1
345
 
\fBNote\fR
346
 
.ps -1
347
 
.br
348
 
Not working at the moment
349
 
.sp .5v
350
 
.EM yellow
351
 
.RE
352
 
.RE
353
 
.PP
354
 
samrepl
355
 
.RS 4
356
 
Send sam replication message, with specified serial\&. Can only be sent to
357
 
\fBsmbd\fR\&. Should not be used manually\&.
358
 
.RE
359
 
.PP
360
 
dmalloc\-mark
361
 
.RS 4
362
 
Set a mark for dmalloc\&. Can be sent to both smbd and nmbd\&. Only available if samba is built with dmalloc support\&.
363
 
.RE
364
 
.PP
365
 
dmalloc\-log\-changed
366
 
.RS 4
367
 
Dump the pointers that have changed since the mark set by dmalloc\-mark\&. Can be sent to both smbd and nmbd\&. Only available if samba is built with dmalloc support\&.
368
 
.RE
369
 
.PP
370
 
shutdown
371
 
.RS 4
372
 
Shut down specified daemon\&. Can be sent to both smbd and nmbd\&.
373
 
.RE
374
 
.PP
375
 
pool\-usage
376
 
.RS 4
377
 
Print a human\-readable description of all talloc(pool) memory usage by the specified daemon/process\&. Available for both smbd and nmbd\&.
378
 
.RE
379
 
.PP
380
 
drvupgrade
381
 
.RS 4
382
 
Force clients of printers using specified driver to update their local version of the driver\&. Can only be sent to smbd\&.
383
 
.RE
384
 
.PP
385
 
reload\-config
386
 
.RS 4
387
 
Force daemon to reload smb\&.conf configuration file\&. Can be sent to
388
 
\fBsmbd\fR,
389
 
\fBnmbd\fR, or
390
 
\fBwinbindd\fR\&.
391
 
.RE
392
 
.SH "VERSION"
393
 
.PP
394
 
This man page is correct for version 3 of the Samba suite\&.
395
 
.SH "SEE ALSO"
396
 
.PP
397
 
\fBnmbd\fR(8)
398
 
and
399
 
\fBsmbd\fR(8)\&.
400
 
.SH "AUTHOR"
401
 
.PP
402
 
The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.
403
 
.PP
404
 
The original Samba man pages were written by Karl Auer\&. The man page sources were converted to YODL format (another excellent piece of Open Source software, available at
405
 
ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) and updated for the Samba 2\&.0 release by Jeremy Allison\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.