Ignore:
Timestamp:
Nov 24, 2016, 1:14:11 PM (9 years ago)
Author:
Silvan Scherrer
Message:

Samba Server: update vendor to version 4.4.3

File:
1 edited

Legend:

Unmodified
Added
Removed
  • vendor/current/docs/manpages/net.8

    r860 r988  
    22.\"     Title: net
    33.\"    Author: [see the "AUTHOR" section]
    4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
    5 .\"      Date: 09/18/2013
     4.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
     5.\"      Date: 05/02/2016
    66.\"    Manual: System Administration tools
    7 .\"    Source: Samba 3.6
     7.\"    Source: Samba 4.4
    88.\"  Language: English
    99.\"
    10 .TH "NET" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
     10.TH "NET" "8" "05/02/2016" "Samba 4\&.4" "System Administration tools"
    1111.\" -----------------------------------------------------------------
    1212.\" * Define some portability stuff
     
    3232.SH "SYNOPSIS"
    3333.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]
     34net {<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]
    3535.SH "DESCRIPTION"
    3636.PP
     
    4242.SH "OPTIONS"
    4343.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
    5545.RS 4
    5646Sets target workgroup or domain\&. You have to specify either this option or the IP address or the name of a server\&.
    5747.RE
    5848.PP
    59 \-W workgroup
     49\-W|\-\-myworkgroup workgroup
    6050.RS 4
    6151Sets client workgroup or domain
    6252.RE
    6353.PP
    64 \-U user
     54\-U|\-\-user user
    6555.RS 4
    6656User name to use
    6757.RE
    6858.PP
    69 \-I ip\-address
     59\-I|\-\-ipaddress ip\-address
    7060.RS 4
    7161IP address of target server to use\&. You have to specify either this option or a target workgroup or a target server\&.
    7262.RE
    7363.PP
    74 \-p port
     64\-p|\-\-port port
    7565.RS 4
    7666Port on the target server to connect to (usually 139 or 445)\&. Defaults to trying 445 first, then 139\&.
    7767.RE
    7868.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
    9770.RS 4
    9871Name of target server\&. You should specify either this option or a target workgroup or a target IP address\&.
    9972.RE
    10073.PP
    101 \-l
     74\-l|\-\-long
    10275.RS 4
    10376When listing data, give more information on each item\&.
    10477.RE
    10578.PP
    106 \-P
     79\-v|\-\-verbose
     80.RS 4
     81When listing data, give more verbose information on each item\&.
     82.RE
     83.PP
     84\-f|\-\-force
     85.RS 4
     86Enforcing a net command\&.
     87.RE
     88.PP
     89\-P|\-\-machine\-pass
    10790.RS 4
    10891Make queries to the external server using the machine account of the local server\&.
     
    11497.RE
    11598.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
     101Set timeout for client operations to 30 seconds\&.
     102.RE
     103.PP
     104\-\-use\-ccache
     105.RS 4
     106Try to use the credentials cached by winbind\&.
     107.RE
     108.PP
     109\-i|\-\-stdin
     110.RS 4
     111Take input for net commands from standard input\&.
     112.RE
     113.PP
     114\-\-tallocreport
     115.RS 4
     116Generate a talloc report while processing a net command\&.
     117.RE
     118.PP
     119\-T|\-\-test
     120.RS 4
     121Only test command sequence, dry\-run\&.
     122.RE
     123.PP
     124\-F|\-\-flags FLAGS
     125.RS 4
     126Pass down integer flags to a net subcommand\&.
     127.RE
     128.PP
     129\-C|\-\-comment COMMENT
     130.RS 4
     131Pass down a comment string to a net subcommand\&.
     132.RE
     133.PP
     134\-n|\-\-myname MYNAME
     135.RS 4
     136Use MYNAME as a requester name for a net subcommand\&.
     137.RE
     138.PP
     139\-c|\-\-container CONTAINER
     140.RS 4
     141Use a specific AD container for net ads operations\&.
     142.RE
     143.PP
     144\-M|\-\-maxusers MAXUSERS
     145.RS 4
     146Fill in the maxusers field in net rpc share operations\&.
     147.RE
     148.PP
     149\-r|\-\-reboot
     150.RS 4
     151Reboot 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
     156When 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
     161When 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
     166When 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
     171Define dbfile for "net idmap" commands\&.
     172.RE
     173.PP
     174\-\-lock
     175.RS 4
     176Activates locking of the dbfile for "net idmap check" command\&.
     177.RE
     178.PP
     179\-a|\-\-auto
     180.RS 4
     181Activates noninteractive mode in "net idmap check"\&.
     182.RE
     183.PP
     184\-\-repair
     185.RS 4
     186Activates repair mode in "net idmap check"\&.
     187.RE
     188.PP
     189\-\-acls
     190.RS 4
     191Includes ACLs to be copied in "net rpc share migrate"\&.
     192.RE
     193.PP
     194\-\-attrs
     195.RS 4
     196Includes file attributes to be copied in "net rpc share migrate"\&.
     197.RE
     198.PP
     199\-\-timestamps
     200.RS 4
     201Includes timestamps to be copied in "net rpc share migrate"\&.
     202.RE
     203.PP
     204\-X|\-\-exclude DIRECTORY
     205.RS 4
     206Allows one to exclude directories when copying with "net rpc share migrate"\&.
     207.RE
     208.PP
     209\-\-destination SERVERNAME
     210.RS 4
     211Defines the target servername of migration process (defaults to localhost)\&.
     212.RE
     213.PP
     214\-L|\-\-local
     215.RS 4
     216Sets the type of group mapping to local (used in "net groupmap set")\&.
     217.RE
     218.PP
     219\-D|\-\-domain
     220.RS 4
     221Sets the type of group mapping to domain (used in "net groupmap set")\&.
     222.RE
     223.PP
     224\-N|\-\-ntname NTNAME
     225.RS 4
     226Sets the ntname of a group mapping (used in "net groupmap set")\&.
     227.RE
     228.PP
     229\-R|\-\-rid RID
     230.RS 4
     231Sets the rid of a group mapping (used in "net groupmap set")\&.
     232.RE
     233.PP
     234\-\-reg\-version REG_VERSION
     235.RS 4
     236Assume database version {n|1,2,3} (used in "net registry check")\&.
     237.RE
     238.PP
     239\-o|\-\-output FILENAME
     240.RS 4
     241Output database file (used in "net registry check")\&.
     242.RE
     243.PP
     244\-\-wipe
     245.RS 4
     246Create a new database from scratch (used in "net registry check")\&.
     247.RE
     248.PP
     249\-\-precheck PRECHECK_DB_FILENAME
     250.RS 4
     251Defines filename for database prechecking (used in "net registry import")\&.
     252.RE
     253.PP
     254\-\-no\-dns\-updates
     255.RS 4
     256Do not perform DNS updates as part of "net ads join"\&.
    130257.RE
    131258.SH "COMMANDS"
     
    142269Without any options, the
    143270NET TIME
    144 command displays the time on the remote server\&.
     271command displays the time on the remote server\&. The remote server must be specified with the \-S option\&.
    145272.SS "TIME SYSTEM"
    146273.PP
    147274Displays 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\&.
    149276.SS "TIME SET"
    150277.PP
    151278Tries 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\&.
    153280.SS "TIME ZONE"
    154281.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]"
     282Displays 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]"
    157284.PP
    158285Join 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\&.
     
    163290.PP
    164291[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\&.
    165296.SS "[RPC] OLDJOIN [options]"
    166297.PP
     
    249380.PP
    250381Validate 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 .sp
    253 .\}
    254 .RS 4
    255 .it 1 an-trap
    256 .nr an-no-space-flag 1
    257 .nr an-break-flag 1
    258 .br
    259 .ps +1
    260 \fBNote\fR
    261 .ps -1
    262 .br
    263 .PP
    264 Currently NOT implemented\&.
    265 .sp .5v
    266 .RE
    267382.SS "RAP GROUPMEMBER"
    268383.SS "RAP GROUPMEMBER LIST GROUP"
     
    280395\fIcommand\fR
    281396on the remote server\&. Only works with OS/2 servers\&.
    282 .if n \{\
    283 .sp
    284 .\}
    285 .RS 4
    286 .it 1 an-trap
    287 .nr an-no-space-flag 1
    288 .nr an-break-flag 1
    289 .br
    290 .ps +1
    291 \fBNote\fR
    292 .ps -1
    293 .br
    294 .PP
    295 Currently NOT implemented\&.
    296 .sp .5v
    297 .RE
    298397.SS "RAP SERVICE"
    299398.SS "RAP SERVICE START NAME [arguments...]"
    300399.PP
    301400Start the specified service on the remote server\&. Not implemented yet\&.
    302 .if n \{\
    303 .sp
    304 .\}
    305 .RS 4
    306 .it 1 an-trap
    307 .nr an-no-space-flag 1
    308 .nr an-break-flag 1
    309 .br
    310 .ps +1
    311 \fBNote\fR
    312 .ps -1
    313 .br
    314 .PP
    315 Currently NOT implemented\&.
    316 .sp .5v
    317 .RE
    318401.SS "RAP SERVICE STOP"
    319402.PP
    320403Stop the specified service on the remote server\&.
    321 .if n \{\
    322 .sp
    323 .\}
    324 .RS 4
    325 .it 1 an-trap
    326 .nr an-no-space-flag 1
    327 .nr an-break-flag 1
    328 .br
    329 .ps +1
    330 \fBNote\fR
    331 .ps -1
    332 .br
    333 .PP
    334 Currently NOT implemented\&.
    335 .sp .5v
    336 .RE
    337404.SS "RAP PASSWORD \fIUSER\fR \fIOLDPASS\fR \fINEWPASS\fR"
    338405.PP
     
    508575.SS "GROUPMAP MODIFY"
    509576.PP
    510 Update en existing group entry\&.
    511 .PP
    512 
    513 .sp
     577Update an existing group entry\&.
     578.PP
    514579.if n \{\
    515580.RS 4
     
    565630.PP
    566631List all interdomain trust relationships\&.
    567 .SS "RPC TRUSTDOM LIST"
    568 .PP
    569 List all interdomain trust relationships\&.
    570632.SS "RPC TRUST"
    571633.SS "RPC TRUST CREATE"
    572634.PP
    573 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\&.
     635Create 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\&.
    574636.PP
    575637\fBOptions:\fR
     
    644706.SS "RPC TRUST DELETE"
    645707.PP
    646 Delete a trust trust object by calling lsaDeleteTrustedDomain\&. The can be done on a single server or on two servers at once\&.
     708Delete a trust object by calling lsaDeleteTrustedDomain\&. The can be done on a single server or on two servers at once\&.
    647709.PP
    648710\fBOptions:\fR
     
    735797.SS "RPC VAMPIRE"
    736798.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\&.
     799Export 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\&.
    738800.SS "RPC VAMPIRE KEYTAB"
    739801.PP
     
    781843.PP
    782844Print out workgroup name for specified kerberos realm\&.
     845.SS "ADS ENCTYPES"
     846.PP
     847List, modify or delete the value of the "msDS\-SupportedEncryptionTypes" attribute of an account in AD\&.
     848.PP
     849This 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
     8510x00000001 DES\-CBC\-CRC
     852.PP
     8530x00000002 DES\-CBC\-MD5
     854.PP
     8550x00000004 RC4\-HMAC
     856.PP
     8570x00000008 AES128\-CTS\-HMAC\-SHA1\-96
     858.PP
     8590x00000010 AES256\-CTS\-HMAC\-SHA1\-96
     860.SS "ADS ENCTYPES LIST \fI<ACCOUNTNAME>\fR"
     861.PP
     862List the value of the "msDS\-SupportedEncryptionTypes" attribute of a given account\&.
     863.PP
     864Example:
     865\fBnet ads enctypes list Computername\fR
     866.SS "ADS ENCTYPES SET \fI<ACCOUNTNAME>\fR \fI[enctypes]\fR"
     867.PP
     868Set 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
     870Example:
     871\fBnet ads enctypes set Computername 24\fR
     872.SS "ADS ENCTYPES DELETE \fI<ACCOUNTNAME>\fR"
     873.PP
     874Deletes the "msDS\-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME\&.
     875.PP
     876Example:
     877\fBnet ads enctypes set Computername 24\fR
    783878.SS "SAM CREATEBUILTINGROUP <NAME>"
    784879.PP
     
    874969.PP
    875970Restore the mappings from the specified file or stdin\&.
    876 .SS "IDMAP SECRET <DOMAIN> <secret>"
     971.SS "IDMAP SET SECRET <DOMAIN> <secret>"
    877972.PP
    878973Store 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
     976Store a domain\-range mapping for a given domain (and index) in autorid database\&.
     977.SS "IDMAP SET CONFIG <config> [\-\-db=<DB>]"
     978.PP
     979Update CONFIG entry in autorid database\&.
     980.SS "IDMAP GET RANGE <SID> [index] [\-\-db=<DB>]"
     981.PP
     982Get the range for a given domain and index from autorid database\&.
     983.SS "IDMAP GET RANGES [<SID>] [\-\-db=<DB>]"
     984.PP
     985Get ranges for all domains or for one identified by given SID\&.
     986.SS "IDMAP GET CONFIG [\-\-db=<DB>]"
     987.PP
     988Get CONFIG entry from autorid database\&.
     989.SS "IDMAP DELETE MAPPING [\-f] [\-\-db=<DB>] <ID>"
    880990.PP
    881991Delete 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
     
    884994\fBsmbcontrol\fR(1)
    885995manpage for details\&.
     996.SS "IDMAP DELETE RANGE [\-f] [\-\-db=<TDB>] <RANGE>|(<SID> [<INDEX>])"
     997.PP
     998Delete 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
     1001Delete all domain range mappings for a domain identified by SID\&. Use \-f to delete invalid mappings\&.
    8861002.SS "IDMAP CHECK [\-v] [\-r] [\-a] [\-T] [\-f] [\-l] [\-\-db=<DB>]"
    8871003.PP
     
    10011117.PP
    10021118net 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
     1121Starting 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\&.
    10061122.PP
    10071123The deployment of this configuration data can be activated in two levels from the
     
    10211137The conf commands are:
    10221138.RS 4
    1023 net conf list \- Dump the complete configuration in smb\&.conf like
     1139net [rpc] conf list \- Dump the complete configuration in smb\&.conf like
    10241140format\&.
    10251141.RE
    10261142.RS 4
    1027 net conf import \- Import configuration from file in smb\&.conf
     1143net [rpc] conf import \- Import configuration from file in smb\&.conf
    10281144format\&.
    10291145.RE
    10301146.RS 4
    1031 net conf listshares \- List the registry shares\&.
    1032 .RE
    1033 .RS 4
    1034 net conf drop \- Delete the complete configuration from
     1147net [rpc] conf listshares \- List the registry shares\&.
     1148.RE
     1149.RS 4
     1150net [rpc] conf drop \- Delete the complete configuration from
    10351151registry\&.
    10361152.RE
    10371153.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"
     1154net [rpc] conf showshare \- Show the definition of a registry share\&.
     1155.RE
     1156.RS 4
     1157net [rpc] conf addshare \- Create a new registry share\&.
     1158.RE
     1159.RS 4
     1160net [rpc] conf delshare \- Delete a registry share\&.
     1161.RE
     1162.RS 4
     1163net [rpc] conf setparm \- Store a parameter\&.
     1164.RE
     1165.RS 4
     1166net [rpc] conf getparm \- Retrieve the value of a parameter\&.
     1167.RE
     1168.RS 4
     1169net [rpc] conf delparm \- Delete a parameter\&.
     1170.RE
     1171.RS 4
     1172net [rpc] conf getincludes \- Show the includes of a share definition\&.
     1173.RE
     1174.RS 4
     1175net [rpc] conf setincludes \- Set includes for a share\&.
     1176.RE
     1177.RS 4
     1178net [rpc] conf delincludes \- Delete includes from a share definition\&.
     1179.RE
     1180.SS "[RPC] CONF LIST"
    10651181.PP
    10661182Print 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]"
    10681184.PP
    10691185This 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"
    10711187.PP
    10721188List the names of the shares defined in registry\&.
    1073 .SS "CONF DROP"
     1189.SS "[RPC] CONF DROP"
    10741190.PP
    10751191Delete the complete configuration data from registry\&.
    1076 .SS "CONF SHOWSHARE sharename"
     1192.SS "[RPC] CONF SHOWSHARE sharename"
    10771193.PP
    10781194Show 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]]] "
    10801196.PP
    10811197Create a new share definition in registry\&. The sharename and path have to be given\&. The share name may
    10821198\fInot\fR
    10831199be "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"
    10851201.PP
    10861202Delete a share definition from registry\&.
    1087 .SS "CONF SETPARM section parameter value"
     1203.SS "[RPC] CONF SETPARM section parameter value"
    10881204.PP
    10891205Store 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"
    10911207.PP
    10921208Show a parameter stored in registry\&.
    1093 .SS "CONF DELPARM section parameter"
     1209.SS "[RPC] CONF DELPARM section parameter"
    10941210.PP
    10951211Delete a parameter stored in registry\&.
    1096 .SS "CONF GETINCLUDES section"
     1212.SS "[RPC] CONF GETINCLUDES section"
    10971213.PP
    10981214Get the list of includes for the provided section (global or share)\&.
     
    11011217.PP
    11021218Further 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]+"
    11041220.PP
    11051221Set 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"
    11071223.PP
    11081224Delete the list of includes from the provided section (global or share)\&.
     
    11601276.RS 4
    11611277net registry convert     \- Convert a registration entries (\&.reg) file\&.
     1278.RE
     1279.RS 4
     1280net registry check       \- Check and repair a registry database\&.
    11621281.RE
    11631282.SS "REGISTRY ENUMERATE key "
     
    12091328or
    12101329\fIdword\fR\&. In case of
    1211 \fImulti_sz\fR
    1212 \fIvalue\fR
     1330\fImulti_sz\fR\fIvalue\fR
    12131331may be given multiple times\&.
    12141332.SS "REGISTRY INCREMENT key name [inc]"
     
    12441362from a Security Descriptor Definition Language (SDDL) string
    12451363\fIsd\fR\&.
    1246 .SS "REGISTRY IMPORT file[opt]"
     1364.SS "REGISTRY IMPORT file [--precheck <check-file>] [opt]"
    12471365.PP
    12481366Import a registration entries (\&.reg)
    12491367\fIfile\fR\&.
     1368.PP
     1369The following options are available:
     1370.PP
     1371\-\-precheck \fIcheck\-file\fR
     1372.RS 4
     1373This 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
     1375The 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
    12501423.SS "REGISTRY EXPORT keyfile[opt]"
    12511424.PP
     
    12581431Convert a registration entries (\&.reg) file
    12591432\fIin\fR\&.
     1433.SS "REGISTRY CHECK [-ravTl] [-o <ODB>] [--wipe] [<DB>]"
     1434.PP
     1435Check 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
     1439Interactive repair mode, ask a lot of questions\&.
     1440.RE
     1441.PP
     1442\-a|\-\-auto
     1443.RS 4
     1444Noninteractive repair mode, use default answers\&.
     1445.RE
     1446.PP
     1447\-v|\-\-verbose
     1448.RS 4
     1449Produce more output\&.
     1450.RE
     1451.PP
     1452\-T|\-\-test
     1453.RS 4
     1454Dry run, show what changes would be made but don\*(Aqt touch anything\&.
     1455.RE
     1456.PP
     1457\-l|\-\-lock
     1458.RS 4
     1459Lock the database while doing the check\&.
     1460.RE
     1461.PP
     1462\-\-reg\-version={1,2,3}
     1463.RS 4
     1464Specify 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
     1469Check the specified database\&.
     1470.RE
     1471.PP
     1472\-o|\-\-output <ODB>
     1473.RS 4
     1474Create 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
     1479Replace the registry database instead of modifying the input or overwrite an existing output database\&.
     1480.RE
     1481.PP
     1482.RS 4
     1483.RE
    12601484.SS "EVENTLOG"
    12611485.PP
Note: See TracChangeset for help on using the changeset viewer.