Changeset 988 for vendor/current/docs/manpages/net.8
- Timestamp:
- Nov 24, 2016, 1:14:11 PM (9 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
vendor/current/docs/manpages/net.8
r860 r988 2 2 .\" Title: net 3 3 .\" Author: [see the "AUTHOR" section] 4 .\" Generator: DocBook XSL Stylesheets v1.7 6.1 <http://docbook.sf.net/>5 .\" Date: 0 9/18/20134 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> 5 .\" Date: 05/02/2016 6 6 .\" Manual: System Administration tools 7 .\" Source: Samba 3.67 .\" Source: Samba 4.4 8 8 .\" Language: English 9 9 .\" 10 .TH "NET" "8" "0 9/18/2013" "Samba 3\&.6" "System Administration tools"10 .TH "NET" "8" "05/02/2016" "Samba 4\&.4" "System Administration tools" 11 11 .\" ----------------------------------------------------------------- 12 12 .\" * Define some portability stuff … … 32 32 .SH "SYNOPSIS" 33 33 .HP \w'\ 'u 34 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]34 net {<ads|rap|rpc>} [\-h|\-\-help] [\-w|\-\-workgroup\ workgroup] [\-W|\-\-myworkgroup\ myworkgroup] [\-U|\-\-user\ user] [\-I|\-\-ipaddress\ ip\-address] [\-p|\-\-port\ port] [\-n\ myname] [\-s\ conffile] [\-S|\-\-server\ server] [\-l|\-\-long] [\-v|\-\-verbose] [\-f|\-\-force] [\-P|\-\-machine\-pass] [\-d\ debuglevel] [\-V] [\-\-request\-timeout\ seconds] [\-t|\-\-timeout\ seconds] [\-i|\-\-stdin] [\-\-tallocreport] 35 35 .SH "DESCRIPTION" 36 36 .PP … … 42 42 .SH "OPTIONS" 43 43 .PP 44 \-h|\-\-help 45 .RS 4 46 Print a summary of command line options\&. 47 .RE 48 .PP 49 \-k|\-\-kerberos 50 .RS 4 51 Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&. 52 .RE 53 .PP 54 \-w target\-workgroup 44 \-w|\-\-workgroup target\-workgroup 55 45 .RS 4 56 46 Sets target workgroup or domain\&. You have to specify either this option or the IP address or the name of a server\&. 57 47 .RE 58 48 .PP 59 \-W workgroup49 \-W|\-\-myworkgroup workgroup 60 50 .RS 4 61 51 Sets client workgroup or domain 62 52 .RE 63 53 .PP 64 \-U user54 \-U|\-\-user user 65 55 .RS 4 66 56 User name to use 67 57 .RE 68 58 .PP 69 \-I ip\-address59 \-I|\-\-ipaddress ip\-address 70 60 .RS 4 71 61 IP address of target server to use\&. You have to specify either this option or a target workgroup or a target server\&. 72 62 .RE 73 63 .PP 74 \-p port64 \-p|\-\-port port 75 65 .RS 4 76 66 Port on the target server to connect to (usually 139 or 445)\&. Defaults to trying 445 first, then 139\&. 77 67 .RE 78 68 .PP 79 \-n|\-\-netbiosname <primary NetBIOS name> 80 .RS 4 81 This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the 82 \m[blue]\fBnetbios name\fR\m[] 83 parameter in the 84 smb\&.conf 85 file\&. However, a command line setting will take precedence over settings in 86 smb\&.conf\&. 87 .RE 88 .PP 89 \-s|\-\-configfile <configuration file> 90 .RS 4 91 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 92 smb\&.conf 93 for more information\&. The default configuration file name is determined at compile time\&. 94 .RE 95 .PP 96 \-S server 69 \-S|\-\-server server 97 70 .RS 4 98 71 Name of target server\&. You should specify either this option or a target workgroup or a target IP address\&. 99 72 .RE 100 73 .PP 101 \-l 74 \-l|\-\-long 102 75 .RS 4 103 76 When listing data, give more information on each item\&. 104 77 .RE 105 78 .PP 106 \-P 79 \-v|\-\-verbose 80 .RS 4 81 When listing data, give more verbose information on each item\&. 82 .RE 83 .PP 84 \-f|\-\-force 85 .RS 4 86 Enforcing a net command\&. 87 .RE 88 .PP 89 \-P|\-\-machine\-pass 107 90 .RS 4 108 91 Make queries to the external server using the machine account of the local server\&. … … 114 97 .RE 115 98 .PP 116 \-d|\-\-debuglevel=level 117 .RS 4 118 \fIlevel\fR 119 is an integer from 0 to 10\&. The default value if this parameter is not specified is 0\&. 120 .sp 121 The higher this value, the more detail will be logged to the log files about the activities of the server\&. At level 0, only critical errors and serious warnings will be logged\&. Level 1 is a reasonable level for day\-to\-day running \- it generates a small amount of information about operations carried out\&. 122 .sp 123 Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem\&. Levels above 3 are designed for use only by developers and generate HUGE amounts of log data, most of which is extremely cryptic\&. 124 .sp 125 Note that specifying this parameter here will override the 126 \m[blue]\fBlog level\fR\m[] 127 parameter in the 128 smb\&.conf 129 file\&. 99 \-t|\-\-timeout 30 100 .RS 4 101 Set timeout for client operations to 30 seconds\&. 102 .RE 103 .PP 104 \-\-use\-ccache 105 .RS 4 106 Try to use the credentials cached by winbind\&. 107 .RE 108 .PP 109 \-i|\-\-stdin 110 .RS 4 111 Take input for net commands from standard input\&. 112 .RE 113 .PP 114 \-\-tallocreport 115 .RS 4 116 Generate a talloc report while processing a net command\&. 117 .RE 118 .PP 119 \-T|\-\-test 120 .RS 4 121 Only test command sequence, dry\-run\&. 122 .RE 123 .PP 124 \-F|\-\-flags FLAGS 125 .RS 4 126 Pass down integer flags to a net subcommand\&. 127 .RE 128 .PP 129 \-C|\-\-comment COMMENT 130 .RS 4 131 Pass down a comment string to a net subcommand\&. 132 .RE 133 .PP 134 \-n|\-\-myname MYNAME 135 .RS 4 136 Use MYNAME as a requester name for a net subcommand\&. 137 .RE 138 .PP 139 \-c|\-\-container CONTAINER 140 .RS 4 141 Use a specific AD container for net ads operations\&. 142 .RE 143 .PP 144 \-M|\-\-maxusers MAXUSERS 145 .RS 4 146 Fill in the maxusers field in net rpc share operations\&. 147 .RE 148 .PP 149 \-r|\-\-reboot 150 .RS 4 151 Reboot a remote machine after a command has been successfully executed (e\&.g\&. in remote join operations)\&. 152 .RE 153 .PP 154 \-\-force\-full\-repl 155 .RS 4 156 When calling "net rpc vampire keytab" this option enforces a full re\-creation of the generated keytab file\&. 157 .RE 158 .PP 159 \-\-single\-obj\-repl 160 .RS 4 161 When calling "net rpc vampire keytab" this option allows one to replicate just a single object to the generated keytab file\&. 162 .RE 163 .PP 164 \-\-clean\-old\-entries 165 .RS 4 166 When calling "net rpc vampire keytab" this option allows one to cleanup old entries from the generated keytab file\&. 167 .RE 168 .PP 169 \-\-db 170 .RS 4 171 Define dbfile for "net idmap" commands\&. 172 .RE 173 .PP 174 \-\-lock 175 .RS 4 176 Activates locking of the dbfile for "net idmap check" command\&. 177 .RE 178 .PP 179 \-a|\-\-auto 180 .RS 4 181 Activates noninteractive mode in "net idmap check"\&. 182 .RE 183 .PP 184 \-\-repair 185 .RS 4 186 Activates repair mode in "net idmap check"\&. 187 .RE 188 .PP 189 \-\-acls 190 .RS 4 191 Includes ACLs to be copied in "net rpc share migrate"\&. 192 .RE 193 .PP 194 \-\-attrs 195 .RS 4 196 Includes file attributes to be copied in "net rpc share migrate"\&. 197 .RE 198 .PP 199 \-\-timestamps 200 .RS 4 201 Includes timestamps to be copied in "net rpc share migrate"\&. 202 .RE 203 .PP 204 \-X|\-\-exclude DIRECTORY 205 .RS 4 206 Allows one to exclude directories when copying with "net rpc share migrate"\&. 207 .RE 208 .PP 209 \-\-destination SERVERNAME 210 .RS 4 211 Defines the target servername of migration process (defaults to localhost)\&. 212 .RE 213 .PP 214 \-L|\-\-local 215 .RS 4 216 Sets the type of group mapping to local (used in "net groupmap set")\&. 217 .RE 218 .PP 219 \-D|\-\-domain 220 .RS 4 221 Sets the type of group mapping to domain (used in "net groupmap set")\&. 222 .RE 223 .PP 224 \-N|\-\-ntname NTNAME 225 .RS 4 226 Sets the ntname of a group mapping (used in "net groupmap set")\&. 227 .RE 228 .PP 229 \-R|\-\-rid RID 230 .RS 4 231 Sets the rid of a group mapping (used in "net groupmap set")\&. 232 .RE 233 .PP 234 \-\-reg\-version REG_VERSION 235 .RS 4 236 Assume database version {n|1,2,3} (used in "net registry check")\&. 237 .RE 238 .PP 239 \-o|\-\-output FILENAME 240 .RS 4 241 Output database file (used in "net registry check")\&. 242 .RE 243 .PP 244 \-\-wipe 245 .RS 4 246 Create a new database from scratch (used in "net registry check")\&. 247 .RE 248 .PP 249 \-\-precheck PRECHECK_DB_FILENAME 250 .RS 4 251 Defines filename for database prechecking (used in "net registry import")\&. 252 .RE 253 .PP 254 \-\-no\-dns\-updates 255 .RS 4 256 Do not perform DNS updates as part of "net ads join"\&. 130 257 .RE 131 258 .SH "COMMANDS" … … 142 269 Without any options, the 143 270 NET TIME 144 command displays the time on the remote server\&. 271 command displays the time on the remote server\&. The remote server must be specified with the \-S option\&. 145 272 .SS "TIME SYSTEM" 146 273 .PP 147 274 Displays the time on the remote server in a format ready for 148 /bin/date\&. 275 /bin/date\&. The remote server must be specified with the \-S option\&. 149 276 .SS "TIME SET" 150 277 .PP 151 278 Tries to set the date and time of the local server to that on the remote server using 152 /bin/date\&. 279 /bin/date\&. The remote server must be specified with the \-S option\&. 153 280 .SS "TIME ZONE" 154 281 .PP 155 Displays the timezone in hours from GMT on the remote computer\&.156 .SS "[RPC|ADS] JOIN [TYPE] [\- U username[%password]] [createupn=UPN] [createcomputer=OU] [options]"282 Displays the timezone in hours from GMT on the remote server\&. The remote server must be specified with the \-S option\&. 283 .SS "[RPC|ADS] JOIN [TYPE] [\-\-no\-dns\-updates] [\-U username[%password]] [createupn=UPN] [createcomputer=OU] [machinepass=PASS] [osName=string osVer=string] [options]" 157 284 .PP 158 285 Join a domain\&. If the account already exists on the server, and [TYPE] is MEMBER, the machine will attempt to join automatically\&. (Assuming that the machine has been created in server manager) Otherwise, a password will be prompted for, and a new account may be created\&. … … 163 290 .PP 164 291 [OU] (ADS only) Precreate the computer account in a specific OU\&. The OU string reads from top to bottom without RDNs, and is delimited by a \*(Aq/\*(Aq\&. Please note that \*(Aq\e\*(Aq is used for escape by both the shell and ldap, so it may need to be doubled or quadrupled to pass through, and it is not used as a delimiter\&. 292 .PP 293 [PASS] (ADS only) Set a specific password on the computer account being created by the join\&. 294 .PP 295 [osName=string osVer=String] (ADS only) Set the operatingSystem and operatingSystemVersion attribute during the join\&. Both parameters must be specified for either to take effect\&. 165 296 .SS "[RPC] OLDJOIN [options]" 166 297 .PP … … 249 380 .PP 250 381 Validate whether the specified user can log in to the remote server\&. If the password is not specified on the commandline, it will be prompted\&. 251 .if n \{\252 .sp253 .\}254 .RS 4255 .it 1 an-trap256 .nr an-no-space-flag 1257 .nr an-break-flag 1258 .br259 .ps +1260 \fBNote\fR261 .ps -1262 .br263 .PP264 Currently NOT implemented\&.265 .sp .5v266 .RE267 382 .SS "RAP GROUPMEMBER" 268 383 .SS "RAP GROUPMEMBER LIST GROUP" … … 280 395 \fIcommand\fR 281 396 on the remote server\&. Only works with OS/2 servers\&. 282 .if n \{\283 .sp284 .\}285 .RS 4286 .it 1 an-trap287 .nr an-no-space-flag 1288 .nr an-break-flag 1289 .br290 .ps +1291 \fBNote\fR292 .ps -1293 .br294 .PP295 Currently NOT implemented\&.296 .sp .5v297 .RE298 397 .SS "RAP SERVICE" 299 398 .SS "RAP SERVICE START NAME [arguments...]" 300 399 .PP 301 400 Start the specified service on the remote server\&. Not implemented yet\&. 302 .if n \{\303 .sp304 .\}305 .RS 4306 .it 1 an-trap307 .nr an-no-space-flag 1308 .nr an-break-flag 1309 .br310 .ps +1311 \fBNote\fR312 .ps -1313 .br314 .PP315 Currently NOT implemented\&.316 .sp .5v317 .RE318 401 .SS "RAP SERVICE STOP" 319 402 .PP 320 403 Stop the specified service on the remote server\&. 321 .if n \{\322 .sp323 .\}324 .RS 4325 .it 1 an-trap326 .nr an-no-space-flag 1327 .nr an-break-flag 1328 .br329 .ps +1330 \fBNote\fR331 .ps -1332 .br333 .PP334 Currently NOT implemented\&.335 .sp .5v336 .RE337 404 .SS "RAP PASSWORD \fIUSER\fR \fIOLDPASS\fR \fINEWPASS\fR" 338 405 .PP … … 508 575 .SS "GROUPMAP MODIFY" 509 576 .PP 510 Update en existing group entry\&. 511 .PP 512 513 .sp 577 Update an existing group entry\&. 578 .PP 514 579 .if n \{\ 515 580 .RS 4 … … 565 630 .PP 566 631 List all interdomain trust relationships\&. 567 .SS "RPC TRUSTDOM LIST"568 .PP569 List all interdomain trust relationships\&.570 632 .SS "RPC TRUST" 571 633 .SS "RPC TRUST CREATE" 572 634 .PP 573 Create a trust trustobject 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\&.635 Create a 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\&. 574 636 .PP 575 637 \fBOptions:\fR … … 644 706 .SS "RPC TRUST DELETE" 645 707 .PP 646 Delete a trust trustobject by calling lsaDeleteTrustedDomain\&. The can be done on a single server or on two servers at once\&.708 Delete a trust object by calling lsaDeleteTrustedDomain\&. The can be done on a single server or on two servers at once\&. 647 709 .PP 648 710 \fBOptions:\fR … … 735 797 .SS "RPC VAMPIRE" 736 798 .PP 737 Export users, aliases and groups from remote server to local server\&. You need to run this against the PDC, from a Samba machine joined as a BDC\&. 799 Export users, aliases and groups from remote server to local server\&. You need to run this against the PDC, from a Samba machine joined as a BDC\&. This vampire command cannot be used against an Active Directory, only against an NT4 Domain Controller\&. 738 800 .SS "RPC VAMPIRE KEYTAB" 739 801 .PP … … 781 843 .PP 782 844 Print out workgroup name for specified kerberos realm\&. 845 .SS "ADS ENCTYPES" 846 .PP 847 List, modify or delete the value of the "msDS\-SupportedEncryptionTypes" attribute of an account in AD\&. 848 .PP 849 This attribute allows one to control which Kerberos encryption types are used for the generation of initial and service tickets\&. The value consists of an integer bitmask with the following values: 850 .PP 851 0x00000001 DES\-CBC\-CRC 852 .PP 853 0x00000002 DES\-CBC\-MD5 854 .PP 855 0x00000004 RC4\-HMAC 856 .PP 857 0x00000008 AES128\-CTS\-HMAC\-SHA1\-96 858 .PP 859 0x00000010 AES256\-CTS\-HMAC\-SHA1\-96 860 .SS "ADS ENCTYPES LIST \fI<ACCOUNTNAME>\fR" 861 .PP 862 List the value of the "msDS\-SupportedEncryptionTypes" attribute of a given account\&. 863 .PP 864 Example: 865 \fBnet ads enctypes list Computername\fR 866 .SS "ADS ENCTYPES SET \fI<ACCOUNTNAME>\fR \fI[enctypes]\fR" 867 .PP 868 Set the value of the "msDS\-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME to a given value\&. If the value is omitted, the value is set to 31 which enables all the currently supported encryption types\&. 869 .PP 870 Example: 871 \fBnet ads enctypes set Computername 24\fR 872 .SS "ADS ENCTYPES DELETE \fI<ACCOUNTNAME>\fR" 873 .PP 874 Deletes the "msDS\-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME\&. 875 .PP 876 Example: 877 \fBnet ads enctypes set Computername 24\fR 783 878 .SS "SAM CREATEBUILTINGROUP <NAME>" 784 879 .PP … … 874 969 .PP 875 970 Restore the mappings from the specified file or stdin\&. 876 .SS "IDMAP SE CRET <DOMAIN> <secret>"971 .SS "IDMAP SET SECRET <DOMAIN> <secret>" 877 972 .PP 878 973 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\&. 879 .SS "IDMAP DELETE [\-f] [\-\-db=<DB>] <ID>" 974 .SS "IDMAP SET RANGE <RANGE> <SID> [index] [\-\-db=<DB>]" 975 .PP 976 Store a domain\-range mapping for a given domain (and index) in autorid database\&. 977 .SS "IDMAP SET CONFIG <config> [\-\-db=<DB>]" 978 .PP 979 Update CONFIG entry in autorid database\&. 980 .SS "IDMAP GET RANGE <SID> [index] [\-\-db=<DB>]" 981 .PP 982 Get the range for a given domain and index from autorid database\&. 983 .SS "IDMAP GET RANGES [<SID>] [\-\-db=<DB>]" 984 .PP 985 Get ranges for all domains or for one identified by given SID\&. 986 .SS "IDMAP GET CONFIG [\-\-db=<DB>]" 987 .PP 988 Get CONFIG entry from autorid database\&. 989 .SS "IDMAP DELETE MAPPING [\-f] [\-\-db=<DB>] <ID>" 880 990 .PP 881 991 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 … … 884 994 \fBsmbcontrol\fR(1) 885 995 manpage for details\&. 996 .SS "IDMAP DELETE RANGE [\-f] [\-\-db=<TDB>] <RANGE>|(<SID> [<INDEX>])" 997 .PP 998 Delete a domain range mapping identified by \*(AqRANGE\*(Aq or "domain SID and INDEX" from autorid database\&. Use \-f to delete invalid mappings\&. 999 .SS "IDMAP DELETE RANGES [\-f] [\-\-db=<TDB>] <SID>" 1000 .PP 1001 Delete all domain range mappings for a domain identified by SID\&. Use \-f to delete invalid mappings\&. 886 1002 .SS "IDMAP CHECK [\-v] [\-r] [\-a] [\-T] [\-f] [\-l] [\-\-db=<DB>]" 887 1003 .PP … … 1001 1117 .PP 1002 1118 net usershare list on its own list out the names of the user defined shares that were created by the current user, or restricts the list to share names that match the given wildcard pattern (\*(Aq*\*(Aq matches one or more characters, \*(Aq?\*(Aq matches only one character)\&. If the \*(Aq\-l\*(Aq or \*(Aq\-\-long\*(Aq option is also given, it includes the names of user defined shares created by other users\&. 1003 .SS " CONF"1004 .PP 1005 Starting with version 3\&.2\&.0, a Samba server can be configured by data stored in registry\&. This configuration data can be edited with the new "net conf" commands\&. 1119 .SS "[RPC] CONF" 1120 .PP 1121 Starting with version 3\&.2\&.0, a Samba server can be configured by data stored in registry\&. This configuration data can be edited with the new "net conf" commands\&. There is also the possibility to configure a remote Samba server by enabling the RPC conf mode and specifying the address of the remote server\&. 1006 1122 .PP 1007 1123 The deployment of this configuration data can be activated in two levels from the … … 1021 1137 The conf commands are: 1022 1138 .RS 4 1023 net conf list \- Dump the complete configuration in smb\&.conf like1139 net [rpc] conf list \- Dump the complete configuration in smb\&.conf like 1024 1140 format\&. 1025 1141 .RE 1026 1142 .RS 4 1027 net conf import \- Import configuration from file in smb\&.conf1143 net [rpc] conf import \- Import configuration from file in smb\&.conf 1028 1144 format\&. 1029 1145 .RE 1030 1146 .RS 4 1031 net conf listshares \- List the registry shares\&.1032 .RE 1033 .RS 4 1034 net conf drop \- Delete the complete configuration from1147 net [rpc] conf listshares \- List the registry shares\&. 1148 .RE 1149 .RS 4 1150 net [rpc] conf drop \- Delete the complete configuration from 1035 1151 registry\&. 1036 1152 .RE 1037 1153 .RS 4 1038 net conf showshare \- Show the definition of a registry share\&.1039 .RE 1040 .RS 4 1041 net conf addshare \- Create a new registry share\&.1042 .RE 1043 .RS 4 1044 net conf delshare \- Delete a registry share\&.1045 .RE 1046 .RS 4 1047 net conf setparm \- Store a parameter\&.1048 .RE 1049 .RS 4 1050 net conf getparm \- Retrieve the value of a parameter\&.1051 .RE 1052 .RS 4 1053 net conf delparm \- Delete a parameter\&.1054 .RE 1055 .RS 4 1056 net conf getincludes \- Show the includes of a share definition\&.1057 .RE 1058 .RS 4 1059 net conf setincludes \- Set includes for a share\&.1060 .RE 1061 .RS 4 1062 net conf delincludes \- Delete includes from a share definition\&.1063 .RE 1064 .SS " CONF LIST"1154 net [rpc] conf showshare \- Show the definition of a registry share\&. 1155 .RE 1156 .RS 4 1157 net [rpc] conf addshare \- Create a new registry share\&. 1158 .RE 1159 .RS 4 1160 net [rpc] conf delshare \- Delete a registry share\&. 1161 .RE 1162 .RS 4 1163 net [rpc] conf setparm \- Store a parameter\&. 1164 .RE 1165 .RS 4 1166 net [rpc] conf getparm \- Retrieve the value of a parameter\&. 1167 .RE 1168 .RS 4 1169 net [rpc] conf delparm \- Delete a parameter\&. 1170 .RE 1171 .RS 4 1172 net [rpc] conf getincludes \- Show the includes of a share definition\&. 1173 .RE 1174 .RS 4 1175 net [rpc] conf setincludes \- Set includes for a share\&. 1176 .RE 1177 .RS 4 1178 net [rpc] conf delincludes \- Delete includes from a share definition\&. 1179 .RE 1180 .SS "[RPC] CONF LIST" 1065 1181 .PP 1066 1182 Print the configuration data stored in the registry in a smb\&.conf\-like format to standard output\&. 1067 .SS " CONF IMPORT [--test|-T] filename [section]"1183 .SS "[RPC] CONF IMPORT [--test|-T] filename [section]" 1068 1184 .PP 1069 1185 This command imports configuration from a file in smb\&.conf format\&. If a section encountered in the input file is present in registry, its contents is replaced\&. Sections of registry configuration that have no counterpart in the input file are not affected\&. If you want to delete these, you will have to use the "net conf drop" or "net conf delshare" commands\&. Optionally, a section may be specified to restrict the effect of the import command to that specific section\&. A test mode is enabled by specifying the parameter "\-T" on the commandline\&. In test mode, no changes are made to the registry, and the resulting configuration is printed to standard output instead\&. 1070 .SS " CONF LISTSHARES"1186 .SS "[RPC] CONF LISTSHARES" 1071 1187 .PP 1072 1188 List the names of the shares defined in registry\&. 1073 .SS " CONF DROP"1189 .SS "[RPC] CONF DROP" 1074 1190 .PP 1075 1191 Delete the complete configuration data from registry\&. 1076 .SS " CONF SHOWSHARE sharename"1192 .SS "[RPC] CONF SHOWSHARE sharename" 1077 1193 .PP 1078 1194 Show the definition of the share or section specified\&. It is valid to specify "global" as sharename to retrieve the global configuration options from registry\&. 1079 .SS " CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]] "1195 .SS "[RPC] CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]] " 1080 1196 .PP 1081 1197 Create a new share definition in registry\&. The sharename and path have to be given\&. The share name may 1082 1198 \fInot\fR 1083 1199 be "global"\&. Optionally, values for the very common options "writeable", "guest ok" and a "comment" may be specified\&. The same result may be obtained by a sequence of "net conf setparm" commands\&. 1084 .SS " CONF DELSHARE sharename"1200 .SS "[RPC] CONF DELSHARE sharename" 1085 1201 .PP 1086 1202 Delete a share definition from registry\&. 1087 .SS " CONF SETPARM section parameter value"1203 .SS "[RPC] CONF SETPARM section parameter value" 1088 1204 .PP 1089 1205 Store a parameter in registry\&. The section may be global or a sharename\&. The section is created if it does not exist yet\&. 1090 .SS " CONF GETPARM section parameter"1206 .SS "[RPC] CONF GETPARM section parameter" 1091 1207 .PP 1092 1208 Show a parameter stored in registry\&. 1093 .SS " CONF DELPARM section parameter"1209 .SS "[RPC] CONF DELPARM section parameter" 1094 1210 .PP 1095 1211 Delete a parameter stored in registry\&. 1096 .SS " CONF GETINCLUDES section"1212 .SS "[RPC] CONF GETINCLUDES section" 1097 1213 .PP 1098 1214 Get the list of includes for the provided section (global or share)\&. … … 1101 1217 .PP 1102 1218 Further note that currently, only files can be included from registry configuration\&. In the future, there will be the ability to include configuration data from other registry keys\&. 1103 .SS " CONF SETINCLUDES section [filename]+"1219 .SS "[RPC] CONF SETINCLUDES section [filename]+" 1104 1220 .PP 1105 1221 Set the list of includes for the provided section (global or share) to the given list of one or more filenames\&. The filenames may contain the usual smb\&.conf macros like %I\&. 1106 .SS " CONF DELINCLUDES section"1222 .SS "[RPC] CONF DELINCLUDES section" 1107 1223 .PP 1108 1224 Delete the list of includes from the provided section (global or share)\&. … … 1160 1276 .RS 4 1161 1277 net registry convert \- Convert a registration entries (\&.reg) file\&. 1278 .RE 1279 .RS 4 1280 net registry check \- Check and repair a registry database\&. 1162 1281 .RE 1163 1282 .SS "REGISTRY ENUMERATE key " … … 1209 1328 or 1210 1329 \fIdword\fR\&. In case of 1211 \fImulti_sz\fR 1212 \fIvalue\fR 1330 \fImulti_sz\fR\fIvalue\fR 1213 1331 may be given multiple times\&. 1214 1332 .SS "REGISTRY INCREMENT key name [inc]" … … 1244 1362 from a Security Descriptor Definition Language (SDDL) string 1245 1363 \fIsd\fR\&. 1246 .SS "REGISTRY IMPORT file [opt]"1364 .SS "REGISTRY IMPORT file [--precheck <check-file>] [opt]" 1247 1365 .PP 1248 1366 Import a registration entries (\&.reg) 1249 1367 \fIfile\fR\&. 1368 .PP 1369 The following options are available: 1370 .PP 1371 \-\-precheck \fIcheck\-file\fR 1372 .RS 4 1373 This is a mechanism to check the existence or non\-existence of certain keys or values specified in a precheck file before applying the import file\&. The import file will only be applied if the precheck succeeds\&. 1374 .sp 1375 The check\-file follows the normal registry file syntax with the following semantics: 1376 .sp 1377 .RS 4 1378 .ie n \{\ 1379 \h'-04'\(bu\h'+03'\c 1380 .\} 1381 .el \{\ 1382 .sp -1 1383 .IP \(bu 2.3 1384 .\} 1385 <value name>=<value> checks whether the value exists and has the given value\&. 1386 .RE 1387 .sp 1388 .RS 4 1389 .ie n \{\ 1390 \h'-04'\(bu\h'+03'\c 1391 .\} 1392 .el \{\ 1393 .sp -1 1394 .IP \(bu 2.3 1395 .\} 1396 <value name>=\- checks whether the value does not exist\&. 1397 .RE 1398 .sp 1399 .RS 4 1400 .ie n \{\ 1401 \h'-04'\(bu\h'+03'\c 1402 .\} 1403 .el \{\ 1404 .sp -1 1405 .IP \(bu 2.3 1406 .\} 1407 [key] checks whether the key exists\&. 1408 .RE 1409 .sp 1410 .RS 4 1411 .ie n \{\ 1412 \h'-04'\(bu\h'+03'\c 1413 .\} 1414 .el \{\ 1415 .sp -1 1416 .IP \(bu 2.3 1417 .\} 1418 [\-key] checks whether the key does not exist\&. 1419 .RE 1420 .sp 1421 .RE 1422 .RE 1250 1423 .SS "REGISTRY EXPORT keyfile[opt]" 1251 1424 .PP … … 1258 1431 Convert a registration entries (\&.reg) file 1259 1432 \fIin\fR\&. 1433 .SS "REGISTRY CHECK [-ravTl] [-o <ODB>] [--wipe] [<DB>]" 1434 .PP 1435 Check and repair the registry 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 1436 .PP 1437 \-r|\-\-repair 1438 .RS 4 1439 Interactive repair mode, ask a lot of questions\&. 1440 .RE 1441 .PP 1442 \-a|\-\-auto 1443 .RS 4 1444 Noninteractive repair mode, use default answers\&. 1445 .RE 1446 .PP 1447 \-v|\-\-verbose 1448 .RS 4 1449 Produce more output\&. 1450 .RE 1451 .PP 1452 \-T|\-\-test 1453 .RS 4 1454 Dry run, show what changes would be made but don\*(Aqt touch anything\&. 1455 .RE 1456 .PP 1457 \-l|\-\-lock 1458 .RS 4 1459 Lock the database while doing the check\&. 1460 .RE 1461 .PP 1462 \-\-reg\-version={1,2,3} 1463 .RS 4 1464 Specify the format of the registry database\&. If not given it defaults to the value of the binary or, if an registry\&.tdb is explizitly stated at the commandline, to the value found in the INFO/version record\&. 1465 .RE 1466 .PP 1467 [\-\-db] <DB> 1468 .RS 4 1469 Check the specified database\&. 1470 .RE 1471 .PP 1472 \-o|\-\-output <ODB> 1473 .RS 4 1474 Create a new registry database <ODB> instead of modifying the input\&. If <ODB> is already existing \-\-wipe may be used to overwrite it\&. 1475 .RE 1476 .PP 1477 \-\-wipe 1478 .RS 4 1479 Replace the registry database instead of modifying the input or overwrite an existing output database\&. 1480 .RE 1481 .PP 1482 .RS 4 1483 .RE 1260 1484 .SS "EVENTLOG" 1261 1485 .PP
Note:
See TracChangeset
for help on using the changeset viewer.