← Back to branch summary

~ubuntu-branches/ubuntu/vivid/samba/vivid

« back to all changes in this revision

Viewing changes to docs/manpages/net.8

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2011-12-21 13:18:04 UTC
  • mfrom: (0.39.21 sid)
  • Revision ID: package-import@ubuntu.com-20111221131804-xtlr39wx6njehxxr
Tags: 2:3.6.1-3ubuntu1
* Merge from Debian testing.  Remaining changes:
  + debian/patches/VERSION.patch:
    - set SAMBA_VERSION_SUFFIX to Ubuntu.
  + debian/patches/error-trans.fix-276472:
    - Add the translation of Unix Error code -ENOTSUP to NT Error Code
    - NT_STATUS_NOT_SUPPORTED to prevent the Permission denied error.
  + 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/control:
    - Don't build against or suggest ctdb.
    - Add dependency on samba-common-bin to samba.
  + 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.
  + debian/samba.logrotate, debian/samba-common.dhcp, debian/samba.if-up:
    - Make them upstart compatible
  + debian/samba.postinst: 
    - 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/patches/fix-debuglevel-name-conflict.patch: don't use 'debug_level'
    as a global variable name in an NSS module 
  + Dropped:
    - debian/patches/error-trans.fix-276472
    - debian/patches/fix-debuglevel-name-conflict.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manpages/net.8
2
2
.\"     Title: net
3
3
.\"    Author: [see the "AUTHOR" section]
4
4
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5
 
.\"      Date: 08/02/2011
 
5
.\"      Date: 10/18/2011
6
6
.\"    Manual: System Administration tools
7
 
.\"    Source: Samba 3.5
 
7
.\"    Source: Samba 3.6
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "NET" "8" "08/02/2011" "Samba 3\&.5" "System Administration tools"
 
10
.TH "NET" "8" "10/18/2011" "Samba 3\&.6" "System Administration tools"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * set default formatting
13
13
.\" -----------------------------------------------------------------
37
37
Print a summary of command line options\&.
38
38
.RE
39
39
.PP
 
40
\-k|\-\-kerberos
 
41
.RS 4
 
42
Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&.
 
43
.RE
 
44
.PP
40
45
\-w target\-workgroup
41
46
.RS 4
42
47
Sets target workgroup or domain\&. You have to specify either this option or the IP address or the name of a server\&.
467
472
.IP \(bu 2.3
468
473
.\}
469
474
comment \- Freeform text description of the group
 
475
.RE
470
476
.sp
471
477
.RE
472
478
.SS "GROUPMAP ADD"
549
555
.SS "RPC TRUSTDOM LIST"
550
556
.PP
551
557
List all interdomain trust relationships\&.
 
558
.SS "RPC TRUSTDOM LIST"
 
559
.PP
 
560
List all interdomain trust relationships\&.
 
561
.SS "RPC TRUST"
 
562
.SS "RPC TRUST CREATE"
 
563
.PP
 
564
Create a trust trust object by calling lsaCreateTrustedDomainEx2\&. The can be done on a single server or on two servers at once with the possibility to use a random trust password\&.
 
565
.PP
 
566
\fBOptions:\fR
 
567
.PP
 
568
otherserver
 
569
.RS 4
 
570
Domain controller of the second domain
 
571
.RE
 
572
.PP
 
573
otheruser
 
574
.RS 4
 
575
Admin user in the second domain
 
576
.RE
 
577
.PP
 
578
otherdomainsid
 
579
.RS 4
 
580
SID of the second domain
 
581
.RE
 
582
.PP
 
583
other_netbios_domain
 
584
.RS 4
 
585
NetBIOS (short) name of the second domain
 
586
.RE
 
587
.PP
 
588
otherdomain
 
589
.RS 4
 
590
DNS (full) name of the second domain
 
591
.RE
 
592
.PP
 
593
trustpw
 
594
.RS 4
 
595
Trust password
 
596
.RE
 
597
.PP
 
598
\fBExamples:\fR
 
599
.PP
 
600
Create a trust object on srv1\&.dom1\&.dom for the domain dom2
 
601
.RS 4
 
602
.sp
 
603
.if n \{\
 
604
.RS 4
 
605
.\}
 
606
.nf
 
607
net rpc trust create \e
 
608
    otherdomainsid=S\-x\-x\-xx\-xxxxxxxxxx\-xxxxxxxxxx\-xxxxxxxxx \e
 
609
    other_netbios_domain=dom2 \e
 
610
    otherdomain=dom2\&.dom \e
 
611
    trustpw=12345678 \e
 
612
    \-S srv1\&.dom1\&.dom
 
613
.fi
 
614
.if n \{\
 
615
.RE
 
616
.\}
 
617
.RE
 
618
.PP
 
619
Create a trust relationship between dom1 and dom2
 
620
.RS 4
 
621
.sp
 
622
.if n \{\
 
623
.RS 4
 
624
.\}
 
625
.nf
 
626
net rpc trust create \e
 
627
    otherserver=srv2\&.dom2\&.test \e
 
628
    otheruser=dom2adm \e
 
629
    \-S srv1\&.dom1\&.dom
 
630
.fi
 
631
.if n \{\
 
632
.RE
 
633
.\}
 
634
.RE
 
635
.SS "RPC TRUST DELETE"
 
636
.PP
 
637
Delete a trust trust object by calling lsaDeleteTrustedDomain\&. The can be done on a single server or on two servers at once\&.
 
638
.PP
 
639
\fBOptions:\fR
 
640
.PP
 
641
otherserver
 
642
.RS 4
 
643
Domain controller of the second domain
 
644
.RE
 
645
.PP
 
646
otheruser
 
647
.RS 4
 
648
Admin user in the second domain
 
649
.RE
 
650
.PP
 
651
otherdomainsid
 
652
.RS 4
 
653
SID of the second domain
 
654
.RE
 
655
.PP
 
656
\fBExamples:\fR
 
657
.PP
 
658
Delete a trust object on srv1\&.dom1\&.dom for the domain dom2
 
659
.RS 4
 
660
.sp
 
661
.if n \{\
 
662
.RS 4
 
663
.\}
 
664
.nf
 
665
net rpc trust delete \e
 
666
    otherdomainsid=S\-x\-x\-xx\-xxxxxxxxxx\-xxxxxxxxxx\-xxxxxxxxx \e
 
667
    \-S srv1\&.dom1\&.dom
 
668
.fi
 
669
.if n \{\
 
670
.RE
 
671
.\}
 
672
.RE
 
673
.PP
 
674
Delete a trust relationship between dom1 and dom2
 
675
.RS 4
 
676
.sp
 
677
.if n \{\
 
678
.RS 4
 
679
.\}
 
680
.nf
 
681
net rpc trust delete \e
 
682
    otherserver=srv2\&.dom2\&.test \e
 
683
    otheruser=dom2adm \e
 
684
    \-S srv1\&.dom1\&.dom
 
685
.fi
 
686
.if n \{\
 
687
.RE
 
688
.\}
 
689
.RE
 
690
.SS ""
552
691
.SS "RPC RIGHTS"
553
692
.PP
554
693
This subcommand is used to view and manage Samba\'s rights assignments (also referred to as privileges)\&. There are three options currently available:
725
864
.SS "IDMAP RESTORE [input file]"
726
865
.PP
727
866
Restore the mappings from the specified file or stdin\&.
728
 
.SS "IDMAP SECRET <DOMAIN>|ALLOC <secret>"
 
867
.SS "IDMAP SECRET <DOMAIN> <secret>"
729
868
.PP
730
869
Store a secret for the specified domain, used primarily for domains that use idmap_ldap as a backend\&. In this case the secret is used as the password for the user DN used to bind to the ldap server\&.
 
870
.SS "IDMAP DELETE [\-f] [\-\-db=<DB>] <ID>"
 
871
.PP
 
872
Delete a mapping sid <\-> gid or sid <\-> uid from the IDMAP database\&. The mapping is given by <ID> which may either be a sid: S\-x\-\&.\&.\&., a gid: "GID number" or a uid: "UID number"\&. Use \-f to delete an invalid partial mapping <ID> \-> xx
 
873
.PP
 
874
Use "smbcontrol all idmap \&.\&.\&." to notify running smbd instances\&. See the
 
875
\fBsmbcontrol\fR(1)
 
876
manpage for details\&.
 
877
.SS "IDMAP CHECK [\-v] [\-r] [\-a] [\-T] [\-f] [\-l] [\-\-db=<DB>]"
 
878
.PP
 
879
Check and repair the IDMAP database\&. If no option is given a read only check of the database is done\&. Among others an interactive or automatic repair mode may be chosen with one of the following options:
 
880
.PP
 
881
\-r|\-\-repair
 
882
.RS 4
 
883
Interactive repair mode, ask a lot of questions\&.
 
884
.RE
 
885
.PP
 
886
\-a|\-\-auto
 
887
.RS 4
 
888
Noninteractive repair mode, use default answers\&.
 
889
.RE
 
890
.PP
 
891
\-v|\-\-verbose
 
892
.RS 4
 
893
Produce more output\&.
 
894
.RE
 
895
.PP
 
896
\-f|\-\-force
 
897
.RS 4
 
898
Try to apply changes, even if they do not apply cleanly\&.
 
899
.RE
 
900
.PP
 
901
\-T|\-\-test
 
902
.RS 4
 
903
Dry run, show what changes would be made but don\'t touch anything\&.
 
904
.RE
 
905
.PP
 
906
\-l|\-\-lock
 
907
.RS 4
 
908
Lock the database while doing the check\&.
 
909
.RE
 
910
.PP
 
911
\-\-db <DB>
 
912
.RS 4
 
913
Check the specified database\&.
 
914
.RE
 
915
.PP
 
916
.RS 4
 
917
.RE
 
918
It reports about the finding of the following errors:
 
919
.PP
 
920
Missing reverse mapping:
 
921
.RS 4
 
922
A record with mapping A\->B where there is no B\->A\&. Default action in repair mode is to "fix" this by adding the reverse mapping\&.
 
923
.RE
 
924
.PP
 
925
Invalid mapping:
 
926
.RS 4
 
927
A record with mapping A\->B where B\->C\&. Default action is to "delete" this record\&.
 
928
.RE
 
929
.PP
 
930
Missing or invalid HWM:
 
931
.RS 4
 
932
A high water mark is not at least equal to the largest ID in the database\&. Default action is to "fix" this by setting it to the largest ID found +1\&.
 
933
.RE
 
934
.PP
 
935
Invalid record:
 
936
.RS 4
 
937
Something we failed to parse\&. Default action is to "edit" it in interactive and "delete" it in automatic mode\&.
 
938
.RE
731
939
.SS "USERSHARE"
732
940
.PP
733
941
Starting with version 3\&.0\&.23, a Samba server now supports the ability for non\-root users to add user-defined shares to be exported using the "net usershare" commands\&.
889
1097
.SS "CONF DELINCLUDES section"
890
1098
.PP
891
1099
Delete the list of includes from the provided section (global or share)\&.
 
1100
.SS "REGISTRY"
 
1101
.PP
 
1102
Manipulate Samba\'s registry\&.
 
1103
.PP
 
1104
The registry commands are:
 
1105
.RS 4
 
1106
net registry enumerate   \- Enumerate registry keys and values\&.
 
1107
.RE
 
1108
.RS 4
 
1109
net registry enumerate_recursive \- Enumerate registry key and its subkeys\&.
 
1110
.RE
 
1111
.RS 4
 
1112
net registry createkey   \- Create a new registry key\&.
 
1113
.RE
 
1114
.RS 4
 
1115
net registry deletekey   \- Delete a registry key\&.
 
1116
.RE
 
1117
.RS 4
 
1118
net registry deletekey_recursive \- Delete a registry key with subkeys\&.
 
1119
.RE
 
1120
.RS 4
 
1121
net registry getvalue    \- Print a registry value\&.
 
1122
.RE
 
1123
.RS 4
 
1124
net registry getvalueraw \- Print a registry value (raw format)\&.
 
1125
.RE
 
1126
.RS 4
 
1127
net registry setvalue    \- Set a new registry value\&.
 
1128
.RE
 
1129
.RS 4
 
1130
net registry increment   \- Increment a DWORD registry value under a lock\&.
 
1131
.RE
 
1132
.RS 4
 
1133
net registry deletevalue \- Delete a registry value\&.
 
1134
.RE
 
1135
.RS 4
 
1136
net registry getsd       \- Get security descriptor\&.
 
1137
.RE
 
1138
.RS 4
 
1139
net registry getsd_sdd1  \- Get security descriptor in sddl format\&.
 
1140
.RE
 
1141
.RS 4
 
1142
net registry setsd_sdd1  \- Set security descriptor from sddl format
 
1143
string\&.
 
1144
.RE
 
1145
.RS 4
 
1146
net registry import      \- Import a registration entries (\&.reg) file\&.
 
1147
.RE
 
1148
.RS 4
 
1149
net registry export      \- Export a registration entries (\&.reg) file\&.
 
1150
.RE
 
1151
.RS 4
 
1152
net registry convert     \- Convert a registration entries (\&.reg) file\&.
 
1153
.RE
 
1154
.SS "REGISTRY ENUMERATE key "
 
1155
.PP
 
1156
Enumerate subkeys and values of
 
1157
\fIkey\fR\&.
 
1158
.SS "REGISTRY ENUMERATE_RECURSIVE key "
 
1159
.PP
 
1160
Enumerate values of
 
1161
\fIkey\fR
 
1162
and its subkeys\&.
 
1163
.SS "REGISTRY CREATEKEY key "
 
1164
.PP
 
1165
Create a new
 
1166
\fIkey\fR
 
1167
if not yet existing\&.
 
1168
.SS "REGISTRY DELETEKEY key "
 
1169
.PP
 
1170
Delete the given
 
1171
\fIkey\fR
 
1172
and its values from the registry, if it has no subkeys\&.
 
1173
.SS "REGISTRY DELETEKEY_RECURSIVE key "
 
1174
.PP
 
1175
Delete the given
 
1176
\fIkey\fR
 
1177
and all of its subkeys and values from the registry\&.
 
1178
.SS "REGISTRY GETVALUE key name"
 
1179
.PP
 
1180
Output type and actual value of the value
 
1181
\fIname\fR
 
1182
of the given
 
1183
\fIkey\fR\&.
 
1184
.SS "REGISTRY GETVALUERAW key name"
 
1185
.PP
 
1186
Output the actual value of the value
 
1187
\fIname\fR
 
1188
of the given
 
1189
\fIkey\fR\&.
 
1190
.SS "REGISTRY SETVALUE key name type value ..."
 
1191
.PP
 
1192
Set the value
 
1193
\fIname\fR
 
1194
of an existing
 
1195
\fIkey\fR\&.
 
1196
\fItype\fR
 
1197
may be one of
 
1198
\fIsz\fR,
 
1199
\fImulti_sz\fR
 
1200
or
 
1201
\fIdword\fR\&. In case of
 
1202
\fImulti_sz\fR
 
1203
\fIvalue\fR
 
1204
may be given multiple times\&.
 
1205
.SS "REGISTRY INCREMENT key name [inc]"
 
1206
.PP
 
1207
Increment the DWORD value
 
1208
\fIname\fR
 
1209
of
 
1210
\fIkey\fR
 
1211
by
 
1212
\fIinc\fR
 
1213
while holding a g_lock\&.
 
1214
\fIinc\fR
 
1215
defaults to 1\&.
 
1216
.SS "REGISTRY DELETEVALUE key name"
 
1217
.PP
 
1218
Delete the value
 
1219
\fIname\fR
 
1220
of the given
 
1221
\fIkey\fR\&.
 
1222
.SS "REGISTRY GETSD key"
 
1223
.PP
 
1224
Get the security descriptor of the given
 
1225
\fIkey\fR\&.
 
1226
.SS "REGISTRY GETSD_SDDL key"
 
1227
.PP
 
1228
Get the security descriptor of the given
 
1229
\fIkey\fR
 
1230
as a Security Descriptor Definition Language (SDDL) string\&.
 
1231
.SS "REGISTRY SETSD_SDDL keysd"
 
1232
.PP
 
1233
Set the security descriptor of the given
 
1234
\fIkey\fR
 
1235
from a Security Descriptor Definition Language (SDDL) string
 
1236
\fIsd\fR\&.
 
1237
.SS "REGISTRY IMPORT file[opt]"
 
1238
.PP
 
1239
Import a registration entries (\&.reg)
 
1240
\fIfile\fR\&.
 
1241
.SS "REGISTRY EXPORT keyfile[opt]"
 
1242
.PP
 
1243
Export a
 
1244
\fIkey\fR
 
1245
to a registration entries (\&.reg)
 
1246
\fIfile\fR\&.
 
1247
.SS "REGISTRY CONVERT in out [[inopt] outopt]"
 
1248
.PP
 
1249
Convert a registration entries (\&.reg) file
 
1250
\fIin\fR\&.
892
1251
.SS "EVENTLOG"
893
1252
.PP
894
1253
Starting with version 3\&.4\&.0 net can read, dump, import and export native win32 eventlog files (usually *\&.evt)\&. evt files are used by the native Windows eventviewer tools\&.
1023
1382
.\}
1024
1383
\fIREBOOT\fR
1025
1384
is an optional parameter that can be set to reboot the remote machine after successful join to the domain\&.
 
1385
.RE
1026
1386
.sp
1027
1387
.RE
1028
1388
.PP
1070
1430
.\}
1071
1431
\fIREBOOT\fR
1072
1432
is an optional parameter that can be set to reboot the remote machine after successful unjoin from the domain\&.
 
1433
.RE
1073
1434
.sp
1074
1435
.RE
1075
1436
.PP
1129
1490
.\}
1130
1491
\fIREBOOT\fR
1131
1492
is an optional parameter that can be set to reboot the remote machine after successful rename in the domain\&.
 
1493
.RE
1132
1494
.sp
1133
1495
.RE
1134
1496
.PP
1179
1541
.\}
1180
1542
\fICOMMAND\fR
1181
1543
defines the shell command to execute\&.
 
1544
.RE
1182
1545
.SS "G_LOCK LOCKS"
1183
1546
.PP
1184
1547
Print a list of all currently existing locknames\&.