← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/samba/oneiric-security

« back to all changes in this revision

Viewing changes to .pc/usershare.patch/docs/manpages/net.8

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2011-03-10 10:03:01 UTC
  • mfrom: (0.39.11 sid)
  • Revision ID: james.westby@ubuntu.com-20110310100301-jfjg41wv0iq05zj4
Tags: 2:3.5.8~dfsg-1ubuntu1
https://launchpad.net/bugs/639768
* Merge from debian unstable.  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 addition to authenticated
      ones.
    - add map to guest = Bad user, maps bad username to guest access. 
  + debian/samba-common.config:
    - Do not change priority to high if dhclient3 is installed.
    - Use priority medium instead of high for the workgroup question.
  + debian/mksmbpasswd.awk:
    - Do not add user with UID less than 1000 to smbpasswd
  + debian/control:
    - Make libwbclient0 replace/conflict with hardy's likewise-open.
    - Don't build against or suggest ctdb.
    - Add dependency on samba-common-bin to samba.
    - Add cuups breaks to push the package to aslo upgrade cups (LP: #639768)
  + 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
      profile
    - debian/control: have samba suggest ufw
  + Add apport hook:
    - Created debian/source_samba.py.
    - debian/rules, debian/samba.dirs, debian/samba-common-bin.files: install
  + Switch to upstart:
    - Add debian/samba.{nmbd,smbd}.upstart.
    - Don't ship the /etc/network/if-up.d file.
  + debian/samba.postinst: 
    - Fixed bashism.
    - Avoid scary pdbedit warnings on first import.
  + debian/samba-common.postinst: Add more informative error message for
    the case where smb.conf was manually deleted
  + debian/samba.logrotate: Make it upstart compatible
  + debian/samba-common.dhcp: Fix typo to get a proper parsing in
    /etc/samba/dhcp.
  + Dropped:
    - debian/patches/fix-windows7-print-connection.patch: Merged upstream.
    - debian/patches/security-CVE-2011-0719.patch: Merged upstream. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
.pc/usershare.patch/docs/manpages/net.8
 
1
'\" t
1
2
.\"     Title: net
2
3
.\"    Author: [see the "AUTHOR" section]
3
 
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
4
 
.\"      Date: 06/18/2010
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
 
5
.\"      Date: 03/06/2011
5
6
.\"    Manual: System Administration tools
6
7
.\"    Source: Samba 3.5
7
8
.\"  Language: English
8
9
.\"
9
 
.TH "NET" "8" "06/18/2010" "Samba 3\&.5" "System Administration tools"
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
 
..
 
10
.TH "NET" "8" "03/06/2011" "Samba 3\&.5" "System Administration tools"
159
11
.\" -----------------------------------------------------------------
160
12
.\" * set default formatting
161
13
.\" -----------------------------------------------------------------
166
18
.\" -----------------------------------------------------------------
167
19
.\" * MAIN CONTENT STARTS HERE *
168
20
.\" -----------------------------------------------------------------
169
 
.SH "Name"
 
21
.SH "NAME"
170
22
net \- Tool for administration of Samba and remote CIFS servers\&.
171
 
.SH "Synopsis"
172
 
.fam C
 
23
.SH "SYNOPSIS"
173
24
.HP \w'\ 'u
174
 
\FCnet\F[] {<ads|rap|rpc>} [\-h] [\-w\ workgroup] [\-W\ myworkgroup] [\-U\ user] [\-I\ ip\-address] [\-p\ port] [\-n\ myname] [\-s\ conffile] [\-S\ server] [\-l] [\-P] [\-d\ debuglevel] [\-V] [\-\-request\-timeout\ seconds]
175
 
.fam
 
25
net {<ads|rap|rpc>} [\-h] [\-w\ workgroup] [\-W\ myworkgroup] [\-U\ user] [\-I\ ip\-address] [\-p\ port] [\-n\ myname] [\-s\ conffile] [\-S\ server] [\-l] [\-P] [\-d\ debuglevel] [\-V] [\-\-request\-timeout\ seconds]
176
26
.SH "DESCRIPTION"
177
27
.PP
178
28
This tool is part of the
217
67
This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the
218
68
\m[blue]\fB\%smb.conf.5.html#\fR\m[]
219
69
parameter in the
220
 
\FCsmb\&.conf\F[]
 
70
smb\&.conf
221
71
file\&. However, a command line setting will take precedence over settings in
222
 
\FCsmb\&.conf\F[]\&.
 
72
smb\&.conf\&.
223
73
.RE
224
74
.PP
225
75
\-s|\-\-configfile <configuration file>
226
76
.RS 4
227
77
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
228
 
\FCsmb\&.conf\F[]
 
78
smb\&.conf
229
79
for more information\&. The default configuration file name is determined at compile time\&.
230
80
.RE
231
81
.PP
261
111
Note that specifying this parameter here will override the
262
112
\m[blue]\fB\%smb.conf.5.html#\fR\m[]
263
113
parameter in the
264
 
\FCsmb\&.conf\F[]
 
114
smb\&.conf
265
115
file\&.
266
116
.RE
267
117
.SH "COMMANDS"
271
121
.SS "TIME"
272
122
.PP
273
123
The
274
 
\FCNET TIME\F[]
 
124
NET TIME
275
125
command allows you to view the time on a remote server or synchronise the time on the local server with the time on the remote server\&.
276
126
.SS "TIME"
277
127
.PP
278
128
Without any options, the
279
 
\FCNET TIME\F[]
 
129
NET TIME
280
130
command displays the time on the remote server\&.
281
131
.SS "TIME SYSTEM"
282
132
.PP
283
133
Displays the time on the remote server in a format ready for
284
 
\FC/bin/date\F[]\&.
 
134
/bin/date\&.
285
135
.SS "TIME SET"
286
136
.PP
287
137
Tries to set the date and time of the local server to that on the remote server using
288
 
\FC/bin/date\F[]\&.
 
138
/bin/date\&.
289
139
.SS "TIME ZONE"
290
140
.PP
291
141
Displays the timezone in hours from GMT on the remote computer\&.
354
204
.PP
355
205
List files opened by specified
356
206
\fIuser\fR\&. Please note that
357
 
\FCnet rap file user\F[]
 
207
net rap file user
358
208
does not work against Samba servers\&.
359
209
.SS "SESSION"
360
210
.SS "RAP SESSION"
388
238
.sp
389
239
.\}
390
240
.RS 4
391
 
.BM yellow
392
241
.it 1 an-trap
393
242
.nr an-no-space-flag 1
394
243
.nr an-break-flag 1
400
249
.PP
401
250
Currently NOT implemented\&.
402
251
.sp .5v
403
 
.EM yellow
404
252
.RE
405
253
.SS "RAP GROUPMEMBER"
406
254
.SS "RAP GROUPMEMBER LIST GROUP"
421
269
.sp
422
270
.\}
423
271
.RS 4
424
 
.BM yellow
425
272
.it 1 an-trap
426
273
.nr an-no-space-flag 1
427
274
.nr an-break-flag 1
433
280
.PP
434
281
Currently NOT implemented\&.
435
282
.sp .5v
436
 
.EM yellow
437
283
.RE
438
284
.SS "RAP SERVICE"
439
285
.SS "RAP SERVICE START NAME [arguments...]"
443
289
.sp
444
290
.\}
445
291
.RS 4
446
 
.BM yellow
447
292
.it 1 an-trap
448
293
.nr an-no-space-flag 1
449
294
.nr an-break-flag 1
455
300
.PP
456
301
Currently NOT implemented\&.
457
302
.sp .5v
458
 
.EM yellow
459
303
.RE
460
304
.SS "RAP SERVICE STOP"
461
305
.PP
464
308
.sp
465
309
.\}
466
310
.RS 4
467
 
.BM yellow
468
311
.it 1 an-trap
469
312
.nr an-no-space-flag 1
470
313
.nr an-break-flag 1
476
319
.PP
477
320
Currently NOT implemented\&.
478
321
.sp .5v
479
 
.EM yellow
480
322
.RE
481
323
.SS "RAP PASSWORD \fIUSER\fR \fIOLDPASS\fR \fINEWPASS\fR"
482
324
.PP
634
476
.if n \{\
635
477
.RS 4
636
478
.\}
637
 
.fam C
638
 
.ps -1
639
479
.nf
640
 
.if t \{\
641
 
.sp -1
642
 
.\}
643
 
.BB lightgray adjust-for-leading-newline
644
 
.sp -1
645
 
 
646
480
net groupmap add {rid=int|sid=string} unixgroup=string \e
647
481
        [type={domain|local}] [ntgroup=string] [comment=string]
648
 
.EB lightgray adjust-for-leading-newline
649
 
.if t \{\
650
 
.sp 1
651
 
.\}
652
482
.fi
653
 
.fam
654
 
.ps +1
655
483
.if n \{\
656
484
.RE
657
485
.\}
671
499
.if n \{\
672
500
.RS 4
673
501
.\}
674
 
.fam C
675
 
.ps -1
676
502
.nf
677
 
.if t \{\
678
 
.sp -1
679
 
.\}
680
 
.BB lightgray adjust-for-leading-newline
681
 
.sp -1
682
 
 
683
503
net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \e
684
504
       [comment=string] [type={domain|local}]
685
 
.EB lightgray adjust-for-leading-newline
686
 
.if t \{\
687
 
.sp 1
688
 
.\}
689
505
.fi
690
 
.fam
691
 
.ps +1
692
506
.if n \{\
693
507
.RE
694
508
.\}
720
534
with the account flag
721
535
\fB\'I\'\fR
722
536
(interdomain trust account)\&. This is required for incoming trusts to work\&. It makes Samba be a trusted domain of the foreign (trusting) domain\&. Users of the Samba domain will be made available in the foreign domain\&. If the command is used against localhost it has the same effect as
723
 
\FCsmbpasswd \-a \-i DOMAIN\F[]\&. Please note that both commands expect a appropriate UNIX account\&.
 
537
smbpasswd \-a \-i DOMAIN\&. Please note that both commands expect a appropriate UNIX account\&.
724
538
.SS "RPC TRUSTDOM DEL DOMAIN"
725
539
.PP
726
540
Remove interdomain trust account for
727
541
\fIDOMAIN\fR\&. If it is used against localhost it has the same effect as
728
 
\FCsmbpasswd \-x DOMAIN$\F[]\&.
 
542
smbpasswd \-x DOMAIN$\&.
729
543
.SS "RPC TRUSTDOM ESTABLISH DOMAIN"
730
544
.PP
731
545
Establish a trust relationship to a trusted domain\&. Interdomain account must already be created on the remote PDC\&. This is required for outgoing trusts to work\&. It makes Samba be a trusting domain of a foreign (trusted) domain\&. Users of the foreign domain will be made available in our domain\&. You\'ll need winbind and a working idmap config to make them appear in your system\&.
782
596
.SS "RPC GETSID"
783
597
.PP
784
598
Fetch domain SID and store it in the local
785
 
\FCsecrets\&.tdb\F[]\&.
 
599
secrets\&.tdb\&.
786
600
.SS "ADS LEAVE"
787
601
.PP
788
602
Make the remote host leave the domain it is part of\&.
789
603
.SS "ADS STATUS"
790
604
.PP
791
605
Print out status of machine account of the local machine in ADS\&. Prints out quite some debug info\&. Aimed at developers, regular users should use
792
 
\FCNET ADS TESTJOIN\F[]\&.
 
606
NET ADS TESTJOIN\&.
793
607
.SS "ADS PRINTER"
794
608
.SS "ADS PRINTER INFO [PRINTER] [SERVER]"
795
609
.PP
1329
1143
.SS "G_LOCK DO lockname timeout command"
1330
1144
.PP
1331
1145
Execute a shell command under a global lock\&. This might be useful to define the order in which several shell commands will be executed\&. The locking information is stored in a file called
1332
 
\FCg_lock\&.tdb\F[]\&. In setups with CTDB running, the locking information will be available on all cluster nodes\&.
 
1146
g_lock\&.tdb\&. In setups with CTDB running, the locking information will be available on all cluster nodes\&.
1333
1147
.sp
1334
1148
.RS 4
1335
1149
.ie n \{\