docs/manpages-3/net.8.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="net.8">
   4
   5 <refmeta>
   6         <refentrytitle>net</refentrytitle>
   7         <manvolnum>8</manvolnum>
   8 </refmeta>
   9
  10
  11 <refnamediv>
  12         <refname>net</refname>
  13         <refpurpose>Tool for administration of Samba and remote
  14         CIFS servers.
  15         </refpurpose>
  16 </refnamediv>
  17
  18 <refsynopsisdiv>
  19         <cmdsynopsis>
  20                 <command>net</command>
  21                 <arg choice="req">&lt;ads|rap|rpc&gt;</arg>
  22                 <arg choice="opt">-h</arg>
  23                 <arg choice="opt">-w workgroup</arg>
  24                 <arg choice="opt">-W myworkgroup</arg>
  25                 <arg choice="opt">-U user</arg>
  26                 <arg choice="opt">-I ip-address</arg>
  27                 <arg choice="opt">-p port</arg>
  28                 <arg choice="opt">-n myname</arg>
  29                 <arg choice="opt">-s conffile</arg>
  30                 <arg choice="opt">-S server</arg>
  31                 <arg choice="opt">-l</arg>
  32                 <arg choice="opt">-P</arg>
  33                 <arg choice="opt">-d debuglevel</arg>
  34                 <arg choice="opt">-V</arg>
  35         </cmdsynopsis>
  36 </refsynopsisdiv>
  37
  38 <refsect1>
  39         <title>DESCRIPTION</title>
  40
  41         <para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle>
  42         <manvolnum>7</manvolnum></citerefentry> suite.</para>
  43
  44         <para>The samba net utility is meant to work just like the net utility
  45         available for windows and DOS. The first argument should be used
  46         to specify the protocol to use when executing a certain command.
  47         ADS is used for ActiveDirectory, RAP is using for old (Win9x/NT3)
  48         clients and RPC can be used for NT4 and Windows 2000. If this
  49         argument is omitted, net will try to determine it automatically.
  50         Not all commands are available on all protocols.
  51         </para>
  52
  53 </refsect1>
  54
  55 <refsect1>
  56         <title>OPTIONS</title>
  57
  58         <variablelist>
  59                 &stdarg.help;
  60
  61                 <varlistentry>
  62                 <term>-w target-workgroup</term>
  63                 <listitem><para>
  64                 Sets target workgroup or domain. You have to specify
  65                 either this option or the IP address or the name of a server.
  66                 </para></listitem>
  67                 </varlistentry>
  68
  69                 <varlistentry>
  70                 <term>-W workgroup</term>
  71                 <listitem><para>
  72                 Sets client workgroup or domain
  73                 </para></listitem>
  74                 </varlistentry>
  75
  76                 <varlistentry>
  77                 <term>-U user</term>
  78                 <listitem><para>
  79                 User name to use
  80                 </para></listitem>
  81                 </varlistentry>
  82
  83                 <varlistentry>
  84                 <term>-I ip-address</term>
  85                 <listitem><para>
  86                 IP address of target server to use. You have to
  87                 specify either this option or a target workgroup or
  88                 a target server.
  89                 </para></listitem>
  90                 </varlistentry>
  91
  92                 <varlistentry>
  93                 <term>-p port</term>
  94                 <listitem><para>
  95                 Port on the target server to connect to (usually 139 or 445).
  96                 Defaults to trying 445 first, then 139.
  97                 </para></listitem>
  98                 </varlistentry>
  99
 100                 &stdarg.netbios.name;
 101                 &stdarg.configfile;
 102
 103                 <varlistentry>
 104                 <term>-S server</term>
 105                 <listitem><para>
 106                 Name of target server. You should specify either
 107                 this option or a target workgroup or a target IP address.
 108                 </para></listitem>
 109                 </varlistentry>
 110
 111                 <varlistentry>
 112                 <term>-l</term>
 113                 <listitem><para>
 114                 When listing data, give more information on each item.
 115                 </para></listitem>
 116                 </varlistentry>
 117
 118                 <varlistentry>
 119                 <term>-P</term>
 120                 <listitem><para>
 121                 Make queries to the external server using the machine account of the local server.
 122                 </para></listitem>
 123                 </varlistentry>
 124
 125                 &stdarg.debug;
 126         </variablelist>
 127 </refsect1>
 128
 129 <refsect1>
 130 <title>COMMANDS</title>
 131
 132 <refsect2>
 133 <title>CHANGESECRETPW</title>
 134
 135 <para>This command allows the Samba machine account password to be set from an external application
 136 to a machine account password that has already been stored in Active Directory. DO NOT USE this command
 137 unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
 138 be used also. There will be NO command prompt. Whatever information is piped into stdin, either by
 139 typing at the command line or otherwise, will be stored as the literal machine password. Do NOT use
 140 this without care and attention as it will overwrite a legitimate machine password without warning.
 141 YOU HAVE BEEN WARNED.
 142 </para>
 143
 144 </refsect2>
 145
 146 <refsect2>
 147         <title>TIME</title>
 148
 149         <para>The <command>NET TIME</command> command allows you to view the time on a remote server
 150         or synchronise the time on the local server with the time on the remote server.</para>
 151
 152 <refsect3>
 153 <title>TIME</title>
 154
 155 <para>Without any options, the <command>NET TIME</command> command
 156 displays the time on the remote server.
 157 </para>
 158
 159 </refsect3>
 160
 161 <refsect3>
 162 <title>TIME SYSTEM</title>
 163
 164 <para>Displays the time on the remote server in a format ready for <command>/bin/date</command></para>
 165
 166 </refsect3>
 167
 168 <refsect3>
 169 <title>TIME SET</title>
 170 <para>Tries to set the date and time of the local server to that on
 171 the remote server using <command>/bin/date</command>. </para>
 172
 173 </refsect3>
 174
 175 <refsect3>
 176 <title>TIME ZONE</title>
 177
 178 <para>Displays the timezone in hours from GMT on the remote computer.</para>
 179
 180 </refsect3>
 181 </refsect2>
 182
 183 <refsect2>
 184 <title>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</title>
 185
 186 <para>
 187 Join a domain.  If the account already exists on the server, and
 188 [TYPE] is MEMBER, the machine will attempt to join automatically.
 189 (Assuming that the machine has been created in server manager)
 190 Otherwise, a password will be prompted for, and a new account may
 191 be created.</para>
 192
 193 <para>
 194 [TYPE] may be PDC, BDC or MEMBER to specify the type of server
 195 joining the domain.
 196 </para>
 197
 198 <para>
 199 [UPN] (ADS only) set the principalname attribute during the join.  The default
 200 format is host/netbiosname@REALM.
 201 </para>
 202
 203 <para>
 204 [OU] (ADS only) Precreate the computer account in a specific OU.  The
 205 OU string reads from top to bottom without RDNs, and is delimited by
 206 a '/'.  Please note that '\' is used for escape by both the shell
 207 and ldap, so it may need to be doubled or quadrupled to pass through,
 208 and it is not used as a delimiter.
 209 </para>
 210 </refsect2>
 211
 212 <refsect2>
 213 <title>[RPC] OLDJOIN [options]</title>
 214
 215 <para>Join a domain. Use the OLDJOIN option to join the domain
 216 using the old style of domain joining - you need to create a trust
 217 account in server manager first.</para>
 218 </refsect2>
 219
 220 <refsect2>
 221 <title>[RPC|ADS] USER</title>
 222
 223 <refsect3>
 224 <title>[RPC|ADS] USER</title>
 225
 226 <para>List all users</para>
 227
 228 </refsect3>
 229
 230 <refsect3>
 231 <title>[RPC|ADS] USER DELETE <replaceable>target</replaceable></title>
 232
 233 <para>Delete specified user</para>
 234
 235 </refsect3>
 236
 237 <refsect3>
 238 <title>[RPC|ADS] USER INFO <replaceable>target</replaceable></title>
 239
 240 <para>List the domain groups of a the specified user.</para>
 241
 242 </refsect3>
 243
 244 <refsect3>
 245 <title>[RPC|ADS] USER RENAME <replaceable>oldname</replaceable> <replaceable>newname</replaceable></title>
 246
 247 <para>Rename specified user.</para>
 248
 249 </refsect3>
 250
 251 <refsect3>
 252 <title>[RPC|ADS] USER ADD <replaceable>name</replaceable> [password] [-F user flags] [-C comment]</title>
 253
 254 <para>Add specified user.</para>
 255 </refsect3>
 256 </refsect2>
 257
 258 <refsect2>
 259 <title>[RPC|ADS] GROUP</title>
 260
 261 <refsect3>
 262 <title>[RPC|ADS] GROUP [misc options] [targets]</title>
 263 <para>List user groups.</para>
 264 </refsect3>
 265
 266 <refsect3>
 267 <title>[RPC|ADS] GROUP DELETE <replaceable>name</replaceable> [misc. options]</title>
 268
 269 <para>Delete specified group.</para>
 270
 271 </refsect3>
 272
 273 <refsect3>
 274 <title>[RPC|ADS] GROUP ADD <replaceable>name</replaceable> [-C comment]</title>
 275
 276 <para>Create specified group.</para>
 277
 278 </refsect3>
 279 </refsect2>
 280
 281 <refsect2>
 282 <title>[RAP|RPC] SHARE</title>
 283
 284 <refsect3>
 285 <title>[RAP|RPC] SHARE [misc. options] [targets]</title>
 286
 287 <para>Enumerates all exported resources (network shares) on target server.</para>
 288
 289 </refsect3>
 290
 291 <refsect3>
 292 <title>[RAP|RPC] SHARE ADD <replaceable>name=serverpath</replaceable> [-C comment] [-M maxusers] [targets]</title>
 293
 294 <para>Adds a share from a server (makes the export active). Maxusers
 295 specifies the number of users that can be connected to the
 296 share simultaneously.</para>
 297
 298 </refsect3>
 299
 300 <refsect3>
 301 <title>SHARE DELETE <replaceable>sharenam</replaceable></title>
 302
 303 <para>Delete specified share.</para>
 304 </refsect3>
 305 </refsect2>
 306
 307 <refsect2>
 308 <title>[RPC|RAP] FILE</title>
 309
 310 <refsect3>
 311 <title>[RPC|RAP] FILE</title>
 312
 313 <para>List all open files on remote server.</para>
 314
 315 </refsect3>
 316
 317 <refsect3>
 318 <title>[RPC|RAP] FILE CLOSE <replaceable>fileid</replaceable></title>
 319
 320 <para>Close file with specified <replaceable>fileid</replaceable> on
 321 remote server.</para>
 322
 323 </refsect3>
 324
 325 <refsect3>
 326 <title>[RPC|RAP] FILE INFO <replaceable>fileid</replaceable></title>
 327
 328 <para>
 329 Print information on specified <replaceable>fileid</replaceable>.
 330 Currently listed are: file-id, username, locks, path, permissions.
 331 </para>
 332
 333 </refsect3>
 334
 335 <refsect3>
 336 <title>[RAP|RPC] FILE USER</title>
 337
 338 &not.implemented;
 339
 340 </refsect3>
 341
 342 </refsect2>
 343
 344 <refsect2>
 345 <title>SESSION</title>
 346
 347 <refsect3>
 348 <title>RAP SESSION</title>
 349
 350 <para>Without any other options, SESSION enumerates all active SMB/CIFS
 351 sessions on the target server.</para>
 352
 353 </refsect3>
 354
 355 <refsect3>
 356 <title>RAP SESSION DELETE|CLOSE <replaceable>CLIENT_NAME</replaceable></title>
 357
 358 <para>Close the specified sessions.</para>
 359
 360 </refsect3>
 361
 362 <refsect3>
 363 <title>RAP SESSION INFO <replaceable>CLIENT_NAME</replaceable></title>
 364
 365 <para>Give a list with all the open files in specified session.</para>
 366
 367 </refsect3>
 368
 369 </refsect2>
 370
 371 <refsect2>
 372 <title>RAP SERVER <replaceable>DOMAIN</replaceable></title>
 373
 374 <para>List all servers in specified domain or workgroup. Defaults
 375 to local domain.</para>
 376
 377 </refsect2>
 378
 379 <refsect2>
 380 <title>RAP DOMAIN</title>
 381
 382 <para>Lists all domains and workgroups visible on the
 383 current network.</para>
 384
 385 </refsect2>
 386
 387 <refsect2>
 388 <title>RAP PRINTQ</title>
 389
 390 <refsect3>
 391 <title>RAP PRINTQ LIST <replaceable>QUEUE_NAME</replaceable></title>
 392
 393 <para>Lists the specified print queue and print jobs on the server.
 394 If the <replaceable>QUEUE_NAME</replaceable> is omitted, all
 395 queues are listed.</para>
 396
 397 </refsect3>
 398
 399 <refsect3>
 400 <title>RAP PRINTQ DELETE <replaceable>JOBID</replaceable></title>
 401
 402 <para>Delete job with specified id.</para>
 403
 404 </refsect3>
 405
 406 </refsect2>
 407
 408 <refsect2>
 409 <title>RAP VALIDATE <replaceable>user</replaceable> [<replaceable>password</replaceable>]</title>
 410
 411 <para>
 412 Validate whether the specified user can log in to the
 413 remote server. If the password is not specified on the commandline, it
 414 will be prompted.
 415 </para>
 416
 417 &not.implemented;
 418
 419 </refsect2>
 420
 421 <refsect2>
 422 <title>RAP GROUPMEMBER</title>
 423
 424 <refsect3>
 425 <title>RAP GROUPMEMBER LIST <replaceable>GROUP</replaceable></title>
 426
 427 <para>List all members of the specified group.</para>
 428
 429 </refsect3>
 430
 431 <refsect3>
 432 <title>RAP GROUPMEMBER DELETE <replaceable>GROUP</replaceable> <replaceable>USER</replaceable></title>
 433
 434 <para>Delete member from group.</para>
 435
 436 </refsect3>
 437
 438 <refsect3>
 439 <title>RAP GROUPMEMBER ADD <replaceable>GROUP</replaceable> <replaceable>USER</replaceable></title>
 440
 441 <para>Add member to group.</para>
 442
 443 </refsect3>
 444
 445 </refsect2>
 446
 447 <refsect2>
 448 <title>RAP ADMIN <replaceable>command</replaceable></title>
 449
 450 <para>Execute the specified <replaceable>command</replaceable> on
 451 the remote server. Only works with OS/2 servers.
 452 </para>
 453
 454 &not.implemented;
 455
 456 </refsect2>
 457
 458 <refsect2>
 459 <title>RAP SERVICE</title>
 460
 461 <refsect3>
 462 <title>RAP SERVICE START <replaceable>NAME</replaceable> [arguments...]</title>
 463
 464 <para>Start the specified service on the remote server. Not implemented yet.</para>
 465
 466 &not.implemented;
 467
 468 </refsect3>
 469
 470 <refsect3>
 471 <title>RAP SERVICE STOP</title>
 472
 473 <para>Stop the specified service on the remote server.</para>
 474
 475 &not.implemented;
 476
 477 </refsect3>
 478
 479 </refsect2>
 480
 481 <refsect2>
 482 <title>RAP PASSWORD <replaceable>USER</replaceable> <replaceable>OLDPASS</replaceable> <replaceable>NEWPASS</replaceable></title>
 483
 484 <para>
 485 Change password of <replaceable>USER</replaceable> from <replaceable>OLDPASS</replaceable> to <replaceable>NEWPASS</replaceable>.
 486 </para>
 487
 488 </refsect2>
 489
 490 <refsect2>
 491 <title>LOOKUP</title>
 492
 493 <refsect3>
 494 <title>LOOKUP HOST <replaceable>HOSTNAME</replaceable> [<replaceable>TYPE</replaceable>]</title>
 495
 496 <para>
 497 Lookup the IP address of the given host with the specified type (netbios suffix).
 498 The type defaults to 0x20 (workstation).
 499 </para>
 500
 501 </refsect3>
 502
 503 <refsect3>
 504 <title>LOOKUP LDAP [<replaceable>DOMAIN</replaceable></title>
 505
 506 <para>Give IP address of LDAP server of specified <replaceable>DOMAIN</replaceable>. Defaults to local domain.</para>
 507
 508 </refsect3>
 509
 510 <refsect3>
 511 <title>LOOKUP KDC [<replaceable>REALM</replaceable>]</title>
 512
 513 <para>Give IP address of KDC for the specified <replaceable>REALM</replaceable>.
 514 Defaults to local realm.</para>
 515
 516 </refsect3>
 517
 518 <refsect3>
 519 <title>LOOKUP DC [<replaceable>DOMAIN</replaceable>]</title>
 520
 521 <para>Give IP's of Domain Controllers for specified <replaceable>
 522 DOMAIN</replaceable>. Defaults to local domain.</para>
 523
 524 </refsect3>
 525
 526 <refsect3>
 527 <title>LOOKUP MASTER <replaceable>DOMAIN</replaceable></title>
 528
 529 <para>Give IP of master browser for specified <replaceable>DOMAIN</replaceable>
 530 or workgroup. Defaults to local domain.</para>
 531
 532 </refsect3>
 533
 534 </refsect2>
 535
 536 <refsect2>
 537 <title>CACHE</title>
 538
 539 <para>Samba uses a general caching interface called 'gencache'. It
 540 can be controlled using 'NET CACHE'.</para>
 541
 542 <para>All the timeout parameters support the suffixes:
 543
 544 <simplelist>
 545 <member>s - Seconds</member>
 546 <member>m - Minutes</member>
 547 <member>h - Hours</member>
 548 <member>d - Days</member>
 549 <member>w - Weeks</member>
 550 </simplelist>
 551
 552 </para>
 553
 554 <refsect3>
 555 <title>CACHE ADD <replaceable>key</replaceable> <replaceable>data</replaceable> <replaceable>time-out</replaceable></title>
 556
 557 <para>Add specified key+data to the cache with the given timeout.</para>
 558
 559 </refsect3>
 560
 561 <refsect3>
 562 <title>CACHE DEL <replaceable>key</replaceable></title>
 563
 564 <para>Delete key from the cache.</para>
 565
 566 </refsect3>
 567
 568 <refsect3>
 569 <title>CACHE SET <replaceable>key</replaceable> <replaceable>data</replaceable> <replaceable>time-out</replaceable></title>
 570
 571 <para>Update data of existing cache entry.</para>
 572
 573 </refsect3>
 574
 575 <refsect3>
 576 <title>CACHE SEARCH <replaceable>PATTERN</replaceable></title>
 577
 578 <para>Search for the specified pattern in the cache data.</para>
 579
 580 </refsect3>
 581
 582 <refsect3>
 583 <title>CACHE LIST</title>
 584
 585 <para>
 586 List all current items in the cache.
 587 </para>
 588
 589 </refsect3>
 590
 591 <refsect3>
 592 <title>CACHE FLUSH</title>
 593
 594 <para>Remove all the current items from the cache.</para>
 595
 596 </refsect3>
 597
 598 </refsect2>
 599
 600 <refsect2>
 601 <title>GETLOCALSID [DOMAIN]</title>
 602
 603 <para>Print the SID of the specified domain, or if the parameter is
 604 omitted, the SID of the domain the local server is in.</para>
 605
 606 </refsect2>
 607
 608 <refsect2>
 609 <title>SETLOCALSID S-1-5-21-x-y-z</title>
 610
 611 <para>Sets domain sid for the local server to the specified SID.</para>
 612
 613 </refsect2>
 614
 615 <refsect2>
 616 <title>GROUPMAP</title>
 617
 618 <para>Manage the mappings between Windows group SIDs and UNIX groups.
 619 Parameters take the for "parameter=value".  Common options include:</para>
 620
 621 <itemizedlist>
 622 <listitem><para>unixgroup - Name of the UNIX group</para></listitem>
 623 <listitem><para>ntgroup - Name of the Windows NT group (must be
 624   resolvable to a SID</para></listitem>
 625 <listitem><para>rid - Unsigned 32-bit integer</para></listitem>
 626 <listitem><para>sid - Full SID in the form of "S-1-..."</para></listitem>
 627 <listitem><para>type - Type of the group; either 'domain', 'local',
 628   or 'builtin'</para></listitem>
 629 <listitem><para>comment - Freeform text description of the group</para></listitem>
 630 </itemizedlist>
 631
 632 <refsect3>
 633 <title>GROUPMAP ADD</title>
 634
 635 <para>
 636 Add a new group mapping entry:
 637 <programlisting>
 638 net groupmap add {rid=int|sid=string} unixgroup=string \
 639       [type={domain|local}] [ntgroup=string] [comment=string]
 640 </programlisting>
 641 </para>
 642
 643 </refsect3>
 644
 645 <refsect3>
 646 <title>GROUPMAP DELETE</title>
 647
 648 <para>Delete a group mapping entry. If more then one group name matches, the first entry found is deleted.</para>
 649
 650 <para>net groupmap delete {ntgroup=string|sid=SID}</para>
 651
 652 </refsect3>
 653
 654 <refsect3>
 655 <title>GROUPMAP MODIFY</title>
 656
 657 <para>Update en existing group entry</para>
 658
 659 <para>
 660 <programlisting>
 661 net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
 662        [comment=string] [type={domain|local}]
 663 </programlisting>
 664 </para>
 665 </refsect3>
 666
 667 <refsect3>
 668 <title>GROUPMAP LIST</title>
 669
 670 <para>List existing group mapping entries</para>
 671
 672 <para>net groupmap list [verbose] [ntgroup=string] [sid=SID]</para>
 673
 674 </refsect3>
 675 </refsect2>
 676
 677
 678
 679 <refsect2>
 680 <title>MAXRID</title>
 681
 682 <para>Prints out the highest RID currently in use on the local
 683 server (by the active 'passdb backend').
 684 </para>
 685
 686 </refsect2>
 687
 688 <refsect2>
 689 <title>RPC INFO</title>
 690
 691 <para>Print information about the domain of the remote server,
 692 such as domain name, domain sid and number of users and groups.
 693 </para>
 694
 695 </refsect2>
 696
 697 <refsect2>
 698 <title>[RPC|ADS] TESTJOIN</title>
 699
 700 <para>Check whether participation in a domain is still valid.</para>
 701
 702 </refsect2>
 703
 704 <refsect2>
 705 <title>[RPC|ADS] CHANGETRUSTPW</title>
 706
 707 <para>Force change of domain trust password.</para>
 708
 709 </refsect2>
 710
 711 <refsect2>
 712 <title>RPC TRUSTDOM</title>
 713
 714 <refsect3>
 715 <title>RPC TRUSTDOM ADD <replaceable>DOMAIN</replaceable></title>
 716
 717 <para>Add a interdomain trust account for
 718 <replaceable>DOMAIN</replaceable> to the remote server.
 719 </para>
 720
 721 </refsect3>
 722
 723 <refsect3>
 724 <title>RPC TRUSTDOM DEL <replaceable>DOMAIM</replaceable></title>
 725
 726 <para>Remove interdomain trust account for
 727 <replaceable>DOMAIN</replaceable> from the remote server.
 728 </para>
 729
 730 &not.implemented;
 731
 732 </refsect3>
 733
 734 <refsect3>
 735 <title>RPC TRUSTDOM ESTABLISH <replaceable>DOMAIN</replaceable></title>
 736
 737 <para>
 738 Establish a trust relationship to a trusting domain.
 739 Interdomain account must already be created on the remote PDC.
 740 </para>
 741
 742 </refsect3>
 743
 744 <refsect3>
 745 <title>RPC TRUSTDOM REVOKE <replaceable>DOMAIN</replaceable></title>
 746 <para>Abandon relationship to trusted domain</para>
 747
 748 </refsect3>
 749
 750 <refsect3>
 751 <title>RPC TRUSTDOM LIST</title>
 752
 753 <para>List all current interdomain trust relationships.</para>
 754
 755 </refsect3>
 756
 757 <refsect3>
 758 <title>RPC RIGHTS</title>
 759
 760 <para>This subcommand is used to view and manage Samba's rights assignments (also
 761 referred to as privileges).  There are three options current available:
 762 <parameter>list</parameter>, <parameter>grant</parameter>, and
 763 <parameter>revoke</parameter>.  More details on Samba's privilege model and its use
 764 can be found in the Samba-HOWTO-Collection.</para>
 765
 766 </refsect3>
 767
 768
 769 </refsect2>
 770
 771 <refsect2>
 772 <title>RPC ABORTSHUTDOWN</title>
 773
 774 <para>Abort the shutdown of a remote server.</para>
 775
 776 </refsect2>
 777
 778 <refsect2>
 779 <title>RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]</title>
 780
 781 <para>Shut down the remote server.</para>
 782
 783 <variablelist>
 784 <varlistentry>
 785 <term>-r</term>
 786 <listitem><para>
 787 Reboot after shutdown.
 788 </para></listitem>
 789 </varlistentry>
 790
 791 <varlistentry>
 792 <term>-f</term>
 793 <listitem><para>
 794 Force shutting down all applications.
 795 </para></listitem>
 796 </varlistentry>
 797
 798 <varlistentry>
 799 <term>-t timeout</term>
 800 <listitem><para>
 801 Timeout before system will be shut down. An interactive
 802 user of the system can use this time to cancel the shutdown.
 803 </para></listitem>
 804 </varlistentry>'>
 805
 806 <varlistentry>
 807 <term>-C message</term>
 808 <listitem><para>Display the specified message on the screen to
 809 announce the shutdown.</para></listitem>
 810 </varlistentry>
 811 </variablelist>
 812
 813 </refsect2>
 814
 815 <refsect2>
 816 <title>RPC SAMDUMP</title>
 817
 818 <para>Print out sam database of remote server. You need
 819 to run this against the PDC, from a Samba machine joined as a BDC. </para>
 820 </refsect2>
 821
 822 <refsect2>
 823 <title>RPC VAMPIRE</title>
 824
 825 <para>Export users, aliases and groups from remote server to
 826 local server.  You need to run this against the PDC, from a Samba machine joined as a BDC.
 827 </para>
 828
 829 </refsect2>
 830
 831 <refsect2>
 832 <title>RPC GETSID</title>
 833
 834 <para>Fetch domain SID and store it in the local <filename>secrets.tdb</filename>. </para>
 835
 836 </refsect2>
 837
 838 <refsect2>
 839 <title>ADS LEAVE</title>
 840
 841 <para>Make the remote host leave the domain it is part of. </para>
 842
 843 </refsect2>
 844
 845 <refsect2>
 846 <title>ADS STATUS</title>
 847
 848 <para>Print out status of machine account of the local machine in ADS.
 849 Prints out quite some debug info. Aimed at developers, regular
 850 users should use <command>NET ADS TESTJOIN</command>.</para>
 851
 852 </refsect2>
 853
 854 <refsect2>
 855 <title>ADS PRINTER</title>
 856
 857 <refsect3>
 858 <title>ADS PRINTER INFO [<replaceable>PRINTER</replaceable>] [<replaceable>SERVER</replaceable>]</title>
 859
 860 <para>
 861 Lookup info for <replaceable>PRINTER</replaceable> on <replaceable>SERVER</replaceable>. The printer name defaults to "*", the
 862 server name defaults to the local host.</para>
 863
 864 </refsect3>
 865
 866 <refsect3>
 867 <title>ADS PRINTER PUBLISH <replaceable>PRINTER</replaceable></title>
 868
 869 <para>Publish specified printer using ADS.</para>
 870
 871 </refsect3>
 872
 873 <refsect3>
 874 <title>ADS PRINTER REMOVE <replaceable>PRINTER</replaceable></title>
 875
 876 <para>Remove specified printer from ADS directory.</para>
 877
 878 </refsect3>
 879
 880 </refsect2>
 881
 882 <refsect2>
 883 <title>ADS SEARCH <replaceable>EXPRESSION</replaceable> <replaceable>ATTRIBUTES...</replaceable></title>
 884
 885 <para>Perform a raw LDAP search on a ADS server and dump the results. The
 886 expression is a standard LDAP search expression, and the
 887 attributes are a list of LDAP fields to show in the results.</para>
 888
 889 <para>Example: <userinput>net ads search '(objectCategory=group)' sAMAccountName</userinput>
 890 </para>
 891
 892 </refsect2>
 893
 894 <refsect2>
 895 <title>ADS DN <replaceable>DN</replaceable> <replaceable>(attributes)</replaceable></title>
 896
 897 <para>
 898 Perform a raw LDAP search on a ADS server and dump the results. The
 899 DN standard LDAP DN, and the attributes are a list of LDAP fields
 900 to show in the result.
 901 </para>
 902
 903 <para>Example: <userinput>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</userinput></para>
 904
 905 </refsect2>
 906
 907 <refsect2>
 908 <title>ADS WORKGROUP</title>
 909
 910 <para>Print out workgroup name for specified kerberos realm.</para>
 911
 912 </refsect2>
 913
 914 <refsect2>
 915 <title>SAM CREATEBUILTINGROUP &lt;NAME&gt;</title>
 916
 917 <para>
 918 (Re)Create a BUILTIN group.
 919 Only a wellknown set of BUILTIN groups can be created with this command.
 920 This is the list of currently recognized group names: Administrators,
 921 Users, Guests, Power Users, Account Operators, Server Operators, Print
 922 Operators, Backup Operators, Replicator, RAS Servers, Pre-Windows 2000
 923 ompatible Access.
 924
 925 This command requires a running Winbindd with idmap allocation properly
 926 configured. The group gid will be allocated out of the winbindd range.
 927 </para>
 928
 929 </refsect2>
 930
 931 <refsect2>
 932 <title>SAM CREATELOCALGROUP &lt;NAME&gt;</title>
 933
 934 <para>
 935 Create a LOCAL group (also known as Alias).
 936
 937 This command requires a running Winbindd with idmap allocation properly
 938 configured. The group gid will be allocated out of the winbindd range.
 939 </para>
 940
 941 </refsect2>
 942
 943 <refsect2>
 944 <title>SAM MAPUNIXGROUP &lt;NAME&gt;</title>
 945
 946 <para>
 947 Map an existing Unix group and make it a Domain Group, the domain group
 948 will have the same name.
 949 </para>
 950
 951 </refsect2>
 952
 953 <refsect2>
 954 <title>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</title>
 955
 956 <para>
 957 Add a member to a Local group. The group can be specified only by name,
 958 the member can be specified by name or SID.
 959 </para>
 960
 961 </refsect2>
 962
 963 <refsect2>
 964 <title>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</title>
 965
 966 <para>
 967 Remove a member from a Local group. The group and the member must be
 968 specified by name.
 969 </para>
 970
 971 </refsect2>
 972
 973 <refsect2>
 974 <title>SAM LISTMEM &lt;GROUP&gt;</title>
 975
 976 <para>
 977 List Local group members. The group must be specified by name.
 978 </para>
 979
 980 </refsect2>
 981
 982 <refsect2>
 983 <title>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</title>
 984
 985 <para>
 986 List the specified set of accounts by name. If verbose is specified,
 987 the rid and description is also provided for each account.
 988 </para>
 989
 990 </refsect2>
 991
 992 <refsect2>
 993 <title>SAM SHOW &lt;NAME&gt;</title>
 994
 995 <para>
 996 Show the full DOMAIN\\NAME the SID and the type for the corrisponding
 997 account.
 998 </para>
 999
1000 </refsect2>
1001
1002 <refsect2>
1003 <title>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</title>
1004
1005 <para>
1006 Set the home directory for a user account.
1007 </para>
1008
1009 </refsect2>
1010
1011 <refsect2>
1012 <title>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</title>
1013
1014 <para>
1015 Set the profile path for a user account.
1016 </para>
1017
1018 </refsect2>
1019
1020 <refsect2>
1021 <title>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</title>
1022
1023 <para>
1024 Set the comment for a user or group account.
1025 </para>
1026
1027 </refsect2>
1028
1029 <refsect2>
1030 <title>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</title>
1031
1032 <para>
1033 Set the full name for a user account.
1034 </para>
1035
1036 </refsect2>
1037
1038 <refsect2>
1039 <title>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</title>
1040
1041 <para>
1042 Set the logon script for a user account.
1043 </para>
1044
1045 </refsect2>
1046
1047 <refsect2>
1048 <title>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</title>
1049
1050 <para>
1051 Set the home drive for a user account.
1052 </para>
1053
1054 </refsect2>
1055
1056 <refsect2>
1057 <title>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</title>
1058
1059 <para>
1060 Set the workstations a user account is allowed to log in from.
1061 </para>
1062
1063 </refsect2>
1064
1065 <refsect2>
1066 <title>SAM SET DISABLE &lt;NAME&gt;</title>
1067
1068 <para>
1069 Set the "disabled" flag for a user account.
1070 </para>
1071
1072 </refsect2>
1073
1074 <refsect2>
1075 <title>SAM SET PWNOTREQ &lt;NAME&gt;</title>
1076
1077 <para>
1078 Set the "password not required" flag for a user account.
1079 </para>
1080
1081 </refsect2>
1082
1083 <refsect2>
1084 <title>SAM SET AUTOLOCK &lt;NAME&gt;</title>
1085
1086 <para>
1087 Set the "autolock" flag for a user account.
1088 </para>
1089
1090 </refsect2>
1091
1092 <refsect2>
1093 <title>SAM SET PWNOEXP &lt;NAME&gt;</title>
1094
1095 <para>
1096 Set the "password do not expire" flag for a user account.
1097 </para>
1098
1099 </refsect2>
1100
1101 <refsect2>
1102 <title>SAM SET PWMUSTCHANGENOW &lt;NAME&gt; [yes|no]</title>
1103
1104 <para>
1105 Set or unset the "password must change" flag fro a user account.
1106 </para>
1107
1108 </refsect2>
1109
1110 <refsect2>
1111 <title>SAM POLICY LIST</title>
1112
1113 <para>
1114 List the avilable account policies.
1115 </para>
1116
1117 </refsect2>
1118
1119 <refsect2>
1120 <title>SAM POLICY SHOW &lt;account policy&gt;</title>
1121
1122 <para>
1123 Show the account policy value.
1124 </para>
1125
1126 </refsect2>
1127
1128 <refsect2>
1129 <title>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</title>
1130
1131 <para>
1132 Set a value for the account policy.
1133 Valid values can be: "forever", "never", "off", or a number.
1134 </para>
1135
1136 </refsect2>
1137
1138 <refsect2>
1139 <title>SAM PROVISION</title>
1140
1141 <para>
1142 Only available if ldapsam:editposix is set and winbindd is running.
1143 Properly populates the ldap tree with the basic accounts (Administrator)
1144 and groups (Domain Users, Domain Admins, Domain Guests) on the ldap tree.
1145 </para>
1146
1147 </refsect2>
1148
1149 <refsect2>
1150 <title>USERSHARE</title>
1151
1152 <para>Starting with version 3.0.23, a Samba server now supports the ability for
1153 non-root users to add user define shares to be exported using the "net usershare"
1154 commands.
1155 </para>
1156
1157 <para>
1158 To set this up, first set up your smb.conf by adding to the [global] section :
1159
1160 usershare path = /usr/local/samba/lib/usershares
1161
1162 Next create the directory /usr/local/samba/lib/usershares, change the owner to root and
1163 set the group owner to the UNIX group who should have the ability to create usershares,
1164 for example a group called "serverops".
1165
1166 Set the permissions on /usr/local/samba/lib/usershares to 01770.
1167
1168 (Owner and group all access, no access for others, plus the sticky bit,
1169 which means that a file in that directory can be renamed or deleted only
1170 by the owner of the file).
1171
1172 Finally, tell smbd how many usershares you will allow by adding to the [global]
1173 section of smb.conf a line such as :
1174
1175 usershare max shares = 100.
1176
1177 To allow 100 usershare definitions. Now, members of the UNIX group "serverops"
1178 can create user defined shares on demand using the commands below.
1179 </para>
1180
1181 <para>The usershare commands are:
1182
1183 <simplelist>
1184 <member>net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] - to add or change a user defined share.</member>
1185 <member>net usershare delete sharename - to delete a user defined share.</member>
1186 <member>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</member>
1187 <member>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</member>
1188 </simplelist>
1189
1190 </para>
1191
1192 <refsect3>
1193 <title>USERSHARE ADD <replaceable>sharename</replaceable> <replaceable>path</replaceable> <replaceable>[comment]</replaceable> <replaceable>[acl]</replaceable> <replaceable>[guest_ok=[y|n]]</replaceable></title>
1194
1195 <para>
1196 Add or replace a new user defined share, with name "sharename".
1197 </para>
1198
1199 <para>
1200 "path" specifies the absolute pathname on the system to be exported.
1201 Restrictions may be put on this, see the global smb.conf parameters :
1202 "usershare owner only", "usershare prefix allow list", and
1203 "usershare prefix deny list".
1204 </para>
1205
1206 <para>
1207 The optional "comment" parameter is the comment that will appear
1208 on the share when browsed to by a client.
1209 </para>
1210
1211 <para>The optional "acl" field
1212 specifies which users have read and write access to the entire share.
1213 Note that guest connections are not allowed unless the smb.conf parameter
1214 "usershare allow guests" has been set. The definition of a user
1215 defined share acl is : "user:permission", where user is a valid
1216 username on the system and permission can be "F", "R", or "D".
1217 "F" stands for "full permissions", ie. read and write permissions.
1218 "D" stands for "deny" for a user, ie. prevent this user from accessing
1219 this share.
1220 "R" stands for "read only", ie. only allow read access to this
1221 share (no creation of new files or directories or writing to files).
1222 </para>
1223
1224 <para>
1225 The default if no "acl" is given is "Everyone:R", which means any
1226 authenticated user has read-only access.
1227 </para>
1228
1229 <para>
1230 The optional "guest_ok" has the same effect as the parameter of the
1231 same name in smb.conf, in that it allows guest access to this user
1232 defined share. This parameter is only allowed if the global parameter
1233 "usershare allow guests" has been set to true in the smb.conf.
1234 </para>
1235
1236 There is no separate command to modify an existing user defined share,
1237 just use the "net usershare add [sharename]" command using the same
1238 sharename as the one you wish to modify and specify the new options
1239 you wish. The Samba smbd daemon notices user defined share modifications
1240 at connect time so will see the change immediately, there is no need
1241 to restart smbd on adding, deleting or changing a user defined share.
1242 </refsect3>
1243
1244 <refsect3>
1245 <title>USERSHARE DELETE <replaceable>sharename</replaceable></title>
1246
1247 <para>
1248 Deletes the user defined share by name. The Samba smbd daemon
1249 immediately notices this change, although it will not disconnect
1250 any users currently connected to the deleted share.
1251 </para>
1252
1253 </refsect3>
1254
1255 <refsect3>
1256 <title>USERSHARE INFO <replaceable>[-l|--long]</replaceable> <replaceable>[wildcard sharename]</replaceable></title>
1257
1258 <para>
1259 Get info on user defined shares owned by the current user matching the given pattern, or all users.
1260 </para>
1261
1262 <para>
1263 net usershare info on its own dumps out info on the user defined shares that were
1264 created by the current user, or restricts them to share names that match the given
1265 wildcard pattern ('*' matches one or more characters, '?' matches only one character).
1266 If the '-l' or '--long' option is also given, it prints out info on user defined
1267 shares created by other users.
1268 </para>
1269
1270 <para>
1271 The information given about a share looks like :
1272
1273 [foobar]
1274 path=/home/jeremy
1275 comment=testme
1276 usershare_acl=Everyone:F
1277 guest_ok=n
1278
1279 And is a list of the current settings of the user defined share that can be
1280 modified by the "net usershare add" command.
1281 </para>
1282
1283 </refsect3>
1284
1285 <refsect3>
1286 <title>USERSHARE LIST <replaceable>[-l|--long]</replaceable> <replaceable>wildcard sharename</replaceable></title>
1287
1288 <para>
1289 List all the user defined shares owned by the current user matching the given pattern, or all users.
1290 </para>
1291
1292 <para>
1293 net usershare list on its own list out the names of the user defined shares that were
1294 created by the current user, or restricts the list to share names that match the given
1295 wildcard pattern ('*' matches one or more characters, '?' matches only one character).
1296 If the '-l' or '--long' option is also given, it includes the names of user defined
1297 shares created by other users.
1298 </para>
1299
1300 </refsect3>
1301
1302 </refsect2>
1303
1304 <refsect2>
1305 <title>HELP [COMMAND]</title>
1306
1307 <para>Gives usage information for the specified command.</para>
1308
1309 </refsect2>
1310
1311 </refsect1>
1312
1313 <refsect1>
1314         <title>VERSION</title>
1315
1316         <para>This man page is complete for version 3.0 of the Samba
1317         suite.</para>
1318 </refsect1>
1319
1320 <refsect1>
1321         <title>AUTHOR</title>
1322
1323         <para>The original Samba software and related utilities
1324         were created by Andrew Tridgell. Samba is now developed
1325         by the Samba Team as an Open Source project similar
1326         to the way the Linux kernel is developed.</para>
1327
1328         <para>The net manpage was written by Jelmer Vernooij.</para>
1329
1330 </refsect1>
1331
1332 </refentry>