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         </cmdsynopsis>
  35 </refsynopsisdiv>
  36
  37 <refsect1>
  38         <title>DESCRIPTION</title>
  39
  40         <para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle>
  41         <manvolnum>7</manvolnum></citerefentry> suite.</para>
  42
  43         <para>The samba net utility is meant to work just like the net utility
  44         available for windows and DOS. The first argument should be used
  45         to specify the protocol to use when executing a certain command.
  46         ADS is used for ActiveDirectory, RAP is using for old (Win9x/NT3)
  47         clients and RPC can be used for NT4 and Windows 2000. If this
  48         argument is omitted, net will try to determine it automatically.
  49         Not all commands are available on all protocols.
  50         </para>
  51
  52 </refsect1>
  53
  54 <refsect1>
  55         <title>OPTIONS</title>
  56
  57         <variablelist>
  58                 &stdarg.help;
  59
  60                 <varlistentry>
  61                 <term>-w target-workgroup</term>
  62                 <listitem><para>
  63                 Sets target workgroup or domain. You have to specify
  64                 either this option or the IP address or the name of a server.
  65                 </para></listitem>
  66                 </varlistentry>
  67
  68                 <varlistentry>
  69                 <term>-W workgroup</term>
  70                 <listitem><para>
  71                 Sets client workgroup or domain
  72                 </para></listitem>
  73                 </varlistentry>
  74
  75                 <varlistentry>
  76                 <term>-U user</term>
  77                 <listitem><para>
  78                 User name to use
  79                 </para></listitem>
  80                 </varlistentry>
  81
  82                 <varlistentry>
  83                 <term>-I ip-address</term>
  84                 <listitem><para>
  85                 IP address of target server to use. You have to
  86                 specify either this option or a target workgroup or
  87                 a target server.
  88                 </para></listitem>
  89                 </varlistentry>
  90
  91                 <varlistentry>
  92                 <term>-p port</term>
  93                 <listitem><para>
  94                 Port on the target server to connect to (usually 139 or 445).
  95                 Defaults to trying 445 first, then 139.
  96                 </para></listitem>
  97                 </varlistentry>
  98
  99                 &stdarg.netbios.name;
 100                 &stdarg.configfile;
 101
 102                 <varlistentry>
 103                 <term>-S server</term>
 104                 <listitem><para>
 105                 Name of target server. You should specify either
 106                 this option or a target workgroup or a target IP address.
 107                 </para></listitem>
 108                 </varlistentry>
 109
 110                 <varlistentry>
 111                 <term>-l</term>
 112                 <listitem><para>
 113                 When listing data, give more information on each item.
 114                 </para></listitem>
 115                 </varlistentry>
 116
 117                 <varlistentry>
 118                 <term>-P</term>
 119                 <listitem><para>
 120                 Make queries to the external server using the machine account of the local server.
 121                 </para></listitem>
 122                 </varlistentry>
 123
 124                 &stdarg.debug;
 125         </variablelist>
 126 </refsect1>
 127
 128 <refsect1>
 129 <title>COMMANDS</title>
 130
 131 <refsect2>
 132 <title>CHANGESECRETPW</title>
 133
 134 <para>This command allows the Samba machine account password to be set from an external application
 135 to a machine account password that has already been stored in Active Directory. DO NOT USE this command
 136 unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
 137 be used also. There will be NO command prompt. Whatever information is piped into stdin, either by
 138 typing at the command line or otherwise, will be stored as the literal machine password. Do NOT use
 139 this without care and attention as it will overwrite a legitimate machine password without warning.
 140 YOU HAVE BEEN WARNED.
 141 </para>
 142
 143 </refsect2>
 144
 145 <refsect2>
 146         <title>TIME</title>
 147
 148         <para>The <command>NET TIME</command> command allows you to view the time on a remote server
 149         or synchronise the time on the local server with the time on the remote server.</para>
 150
 151 <refsect3>
 152 <title>TIME</title>
 153
 154 <para>Without any options, the <command>NET TIME</command> command
 155 displays the time on the remote server.
 156 </para>
 157
 158 </refsect3>
 159
 160 <refsect3>
 161 <title>TIME SYSTEM</title>
 162
 163 <para>Displays the time on the remote server in a format ready for <command>/bin/date</command></para>
 164
 165 </refsect3>
 166
 167 <refsect3>
 168 <title>TIME SET</title>
 169 <para>Tries to set the date and time of the local server to that on
 170 the remote server using <command>/bin/date</command>. </para>
 171
 172 </refsect3>
 173
 174 <refsect3>
 175 <title>TIME ZONE</title>
 176
 177 <para>Displays the timezone in hours from GMT on the remote computer.</para>
 178
 179 </refsect3>
 180 </refsect2>
 181
 182 <refsect2>
 183 <title>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [options]</title>
 184
 185 <para>
 186 Join a domain.  If the account already exists on the server, and
 187 [TYPE] is MEMBER, the machine will attempt to join automatically.
 188 (Assuming that the machine has been created in server manager)
 189 Otherwise, a password will be prompted for, and a new account may
 190 be created.</para>
 191
 192 <para>
 193 [TYPE] may be PDC, BDC or MEMBER to specify the type of server
 194 joining the domain.
 195 </para>
 196 </refsect2>
 197
 198 <refsect2>
 199 <title>[RPC] OLDJOIN [options]</title>
 200
 201 <para>Join a domain. Use the OLDJOIN option to join the domain
 202 using the old style of domain joining - you need to create a trust
 203 account in server manager first.</para>
 204 </refsect2>
 205
 206 <refsect2>
 207 <title>[RPC|ADS] USER</title>
 208
 209 <refsect3>
 210 <title>[RPC|ADS] USER</title>
 211
 212 <para>List all users</para>
 213
 214 </refsect3>
 215
 216 <refsect3>
 217 <title>[RPC|ADS] USER DELETE <replaceable>target</replaceable></title>
 218
 219 <para>Delete specified user</para>
 220
 221 </refsect3>
 222
 223 <refsect3>
 224 <title>[RPC|ADS] USER INFO <replaceable>target</replaceable></title>
 225
 226 <para>List the domain groups of a the specified user.</para>
 227
 228 </refsect3>
 229
 230 <refsect3>
 231 <title>[RPC|ADS] USER RENAME <replaceable>oldname</replaceable> <replaceable>newname</replaceable></title>
 232
 233 <para>Rename specified user.</para>
 234
 235 </refsect3>
 236
 237 <refsect3>
 238 <title>[RPC|ADS] USER ADD <replaceable>name</replaceable> [password] [-F user flags] [-C comment]</title>
 239
 240 <para>Add specified user.</para>
 241 </refsect3>
 242 </refsect2>
 243
 244 <refsect2>
 245 <title>[RPC|ADS] GROUP</title>
 246
 247 <refsect3>
 248 <title>[RPC|ADS] GROUP [misc options] [targets]</title>
 249 <para>List user groups.</para>
 250 </refsect3>
 251
 252 <refsect3>
 253 <title>[RPC|ADS] GROUP DELETE <replaceable>name</replaceable> [misc. options]</title>
 254
 255 <para>Delete specified group.</para>
 256
 257 </refsect3>
 258
 259 <refsect3>
 260 <title>[RPC|ADS] GROUP ADD <replaceable>name</replaceable> [-C comment]</title>
 261
 262 <para>Create specified group.</para>
 263
 264 </refsect3>
 265 </refsect2>
 266
 267 <refsect2>
 268 <title>[RAP|RPC] SHARE</title>
 269
 270 <refsect3>
 271 <title>[RAP|RPC] SHARE [misc. options] [targets]</title>
 272
 273 <para>Enumerates all exported resources (network shares) on target server.</para>
 274
 275 </refsect3>
 276
 277 <refsect3>
 278 <title>[RAP|RPC] SHARE ADD <replaceable>name=serverpath</replaceable> [-C comment] [-M maxusers] [targets]</title>
 279
 280 <para>Adds a share from a server (makes the export active). Maxusers
 281 specifies the number of users that can be connected to the
 282 share simultaneously.</para>
 283
 284 </refsect3>
 285
 286 <refsect3>
 287 <title>SHARE DELETE <replaceable>sharenam</replaceable></title>
 288
 289 <para>Delete specified share.</para>
 290 </refsect3>
 291 </refsect2>
 292
 293 <refsect2>
 294 <title>[RPC|RAP] FILE</title>
 295
 296 <refsect3>
 297 <title>[RPC|RAP] FILE</title>
 298
 299 <para>List all open files on remote server.</para>
 300
 301 </refsect3>
 302
 303 <refsect3>
 304 <title>[RPC|RAP] FILE CLOSE <replaceable>fileid</replaceable></title>
 305
 306 <para>Close file with specified <replaceable>fileid</replaceable> on
 307 remote server.</para>
 308
 309 </refsect3>
 310
 311 <refsect3>
 312 <title>[RPC|RAP] FILE INFO <replaceable>fileid</replaceable></title>
 313
 314 <para>
 315 Print information on specified <replaceable>fileid</replaceable>.
 316 Currently listed are: file-id, username, locks, path, permissions.
 317 </para>
 318
 319 </refsect3>
 320
 321 <refsect3>
 322 <title>[RAP|RPC] FILE USER</title>
 323
 324 &not.implemented;
 325
 326 </refsect3>
 327
 328 </refsect2>
 329
 330 <refsect2>
 331 <title>SESSION</title>
 332
 333 <refsect3>
 334 <title>RAP SESSION</title>
 335
 336 <para>Without any other options, SESSION enumerates all active SMB/CIFS
 337 sessions on the target server.</para>
 338
 339 </refsect3>
 340
 341 <refsect3>
 342 <title>RAP SESSION DELETE|CLOSE <replaceable>CLIENT_NAME</replaceable></title>
 343
 344 <para>Close the specified sessions.</para>
 345
 346 </refsect3>
 347
 348 <refsect3>
 349 <title>RAP SESSION INFO <replaceable>CLIENT_NAME</replaceable></title>
 350
 351 <para>Give a list with all the open files in specified session.</para>
 352
 353 </refsect3>
 354
 355 </refsect2>
 356
 357 <refsect2>
 358 <title>RAP SERVER <replaceable>DOMAIN</replaceable></title>
 359
 360 <para>List all servers in specified domain or workgroup. Defaults
 361 to local domain.</para>
 362
 363 </refsect2>
 364
 365 <refsect2>
 366 <title>RAP DOMAIN</title>
 367
 368 <para>Lists all domains and workgroups visible on the
 369 current network.</para>
 370
 371 </refsect2>
 372
 373 <refsect2>
 374 <title>RAP PRINTQ</title>
 375
 376 <refsect3>
 377 <title>RAP PRINTQ LIST <replaceable>QUEUE_NAME</replaceable></title>
 378
 379 <para>Lists the specified print queue and print jobs on the server.
 380 If the <replaceable>QUEUE_NAME</replaceable> is omitted, all
 381 queues are listed.</para>
 382
 383 </refsect3>
 384
 385 <refsect3>
 386 <title>RAP PRINTQ DELETE <replaceable>JOBID</replaceable></title>
 387
 388 <para>Delete job with specified id.</para>
 389
 390 </refsect3>
 391
 392 </refsect2>
 393
 394 <refsect2>
 395 <title>RAP VALIDATE <replaceable>user</replaceable> [<replaceable>password</replaceable>]</title>
 396
 397 <para>
 398 Validate whether the specified user can log in to the
 399 remote server. If the password is not specified on the commandline, it
 400 will be prompted.
 401 </para>
 402
 403 &not.implemented;
 404
 405 </refsect2>
 406
 407 <refsect2>
 408 <title>RAP GROUPMEMBER</title>
 409
 410 <refsect3>
 411 <title>RAP GROUPMEMBER LIST <replaceable>GROUP</replaceable></title>
 412
 413 <para>List all members of the specified group.</para>
 414
 415 </refsect3>
 416
 417 <refsect3>
 418 <title>RAP GROUPMEMBER DELETE <replaceable>GROUP</replaceable> <replaceable>USER</replaceable></title>
 419
 420 <para>Delete member from group.</para>
 421
 422 </refsect3>
 423
 424 <refsect3>
 425 <title>RAP GROUPMEMBER ADD <replaceable>GROUP</replaceable> <replaceable>USER</replaceable></title>
 426
 427 <para>Add member to group.</para>
 428
 429 </refsect3>
 430
 431 </refsect2>
 432
 433 <refsect2>
 434 <title>RAP ADMIN <replaceable>command</replaceable></title>
 435
 436 <para>Execute the specified <replaceable>command</replaceable> on
 437 the remote server. Only works with OS/2 servers.
 438 </para>
 439
 440 &not.implemented;
 441
 442 </refsect2>
 443
 444 <refsect2>
 445 <title>RAP SERVICE</title>
 446
 447 <refsect3>
 448 <title>RAP SERVICE START <replaceable>NAME</replaceable> [arguments...]</title>
 449
 450 <para>Start the specified service on the remote server. Not implemented yet.</para>
 451
 452 &not.implemented;
 453
 454 </refsect3>
 455
 456 <refsect3>
 457 <title>RAP SERVICE STOP</title>
 458
 459 <para>Stop the specified service on the remote server.</para>
 460
 461 &not.implemented;
 462
 463 </refsect3>
 464
 465 </refsect2>
 466
 467 <refsect2>
 468 <title>RAP PASSWORD <replaceable>USER</replaceable> <replaceable>OLDPASS</replaceable> <replaceable>NEWPASS</replaceable></title>
 469
 470 <para>
 471 Change password of <replaceable>USER</replaceable> from <replaceable>OLDPASS</replaceable> to <replaceable>NEWPASS</replaceable>.
 472 </para>
 473
 474 </refsect2>
 475
 476 <refsect2>
 477 <title>LOOKUP</title>
 478
 479 <refsect3>
 480 <title>LOOKUP HOST <replaceable>HOSTNAME</replaceable> [<replaceable>TYPE</replaceable>]</title>
 481
 482 <para>
 483 Lookup the IP address of the given host with the specified type (netbios suffix).
 484 The type defaults to 0x20 (workstation).
 485 </para>
 486
 487 </refsect3>
 488
 489 <refsect3>
 490 <title>LOOKUP LDAP [<replaceable>DOMAIN</replaceable></title>
 491
 492 <para>Give IP address of LDAP server of specified <replaceable>DOMAIN</replaceable>. Defaults to local domain.</para>
 493
 494 </refsect3>
 495
 496 <refsect3>
 497 <title>LOOKUP KDC [<replaceable>REALM</replaceable>]</title>
 498
 499 <para>Give IP address of KDC for the specified <replaceable>REALM</replaceable>.
 500 Defaults to local realm.</para>
 501
 502 </refsect3>
 503
 504 <refsect3>
 505 <title>LOOKUP DC [<replaceable>DOMAIN</replaceable>]</title>
 506
 507 <para>Give IP's of Domain Controllers for specified <replaceable>
 508 DOMAIN</replaceable>. Defaults to local domain.</para>
 509
 510 </refsect3>
 511
 512 <refsect3>
 513 <title>LOOKUP MASTER <replaceable>DOMAIN</replaceable></title>
 514
 515 <para>Give IP of master browser for specified <replaceable>DOMAIN</replaceable>
 516 or workgroup. Defaults to local domain.</para>
 517
 518 </refsect3>
 519
 520 </refsect2>
 521
 522 <refsect2>
 523 <title>CACHE</title>
 524
 525 <para>Samba uses a general caching interface called 'gencache'. It
 526 can be controlled using 'NET CACHE'.</para>
 527
 528 <para>All the timeout parameters support the suffixes:
 529
 530 <simplelist>
 531 <member>s - Seconds</member>
 532 <member>m - Minutes</member>
 533 <member>h - Hours</member>
 534 <member>d - Days</member>
 535 <member>w - Weeks</member>
 536 </simplelist>
 537
 538 </para>
 539
 540 <refsect3>
 541 <title>CACHE ADD <replaceable>key</replaceable> <replaceable>data</replaceable> <replaceable>time-out</replaceable></title>
 542
 543 <para>Add specified key+data to the cache with the given timeout.</para>
 544
 545 </refsect3>
 546
 547 <refsect3>
 548 <title>CACHE DEL <replaceable>key</replaceable></title>
 549
 550 <para>Delete key from the cache.</para>
 551
 552 </refsect3>
 553
 554 <refsect3>
 555 <title>CACHE SET <replaceable>key</replaceable> <replaceable>data</replaceable> <replaceable>time-out</replaceable></title>
 556
 557 <para>Update data of existing cache entry.</para>
 558
 559 </refsect3>
 560
 561 <refsect3>
 562 <title>CACHE SEARCH <replaceable>PATTERN</replaceable></title>
 563
 564 <para>Search for the specified pattern in the cache data.</para>
 565
 566 </refsect3>
 567
 568 <refsect3>
 569 <title>CACHE LIST</title>
 570
 571 <para>
 572 List all current items in the cache.
 573 </para>
 574
 575 </refsect3>
 576
 577 <refsect3>
 578 <title>CACHE FLUSH</title>
 579
 580 <para>Remove all the current items from the cache.</para>
 581
 582 </refsect3>
 583
 584 </refsect2>
 585
 586 <refsect2>
 587 <title>GETLOCALSID [DOMAIN]</title>
 588
 589 <para>Print the SID of the specified domain, or if the parameter is
 590 omitted, the SID of the domain the local server is in.</para>
 591
 592 </refsect2>
 593
 594 <refsect2>
 595 <title>SETLOCALSID S-1-5-21-x-y-z</title>
 596
 597 <para>Sets domain sid for the local server to the specified SID.</para>
 598
 599 </refsect2>
 600
 601 <refsect2>
 602 <title>GROUPMAP</title>
 603
 604 <para>Manage the mappings between Windows group SIDs and UNIX groups.
 605 Parameters take the for "parameter=value".  Common options include:</para>
 606
 607 <itemizedlist>
 608 <listitem><para>unixgroup - Name of the UNIX group</para></listitem>
 609 <listitem><para>ntgroup - Name of the Windows NT group (must be
 610   resolvable to a SID</para></listitem>
 611 <listitem><para>rid - Unsigned 32-bit integer</para></listitem>
 612 <listitem><para>sid - Full SID in the form of "S-1-..."</para></listitem>
 613 <listitem><para>type - Type of the group; either 'domain', 'local',
 614   or 'builtin'</para></listitem>
 615 <listitem><para>comment - Freeform text description of the group</para></listitem>
 616 </itemizedlist>
 617
 618 <refsect3>
 619 <title>GROUPMAP ADD</title>
 620
 621 <para>Add a new group mapping entry</para>
 622
 623 <para>net groupmap add {rid=int|sid=string} unixgroup=string [type={domain|local}] [ntgroup=string] [comment=string]</para>
 624
 625 </refsect3>
 626
 627 <refsect3>
 628 <title>GROUPMAP DELETE</title>
 629
 630 <para>Delete a group mapping entry. If more then one group name matches, the first entry found is deleted.</para>
 631
 632 <para>net groupmap delete {ntgroup=string|sid=SID}</para>
 633
 634 </refsect3>
 635
 636 <refsect3>
 637 <title>GROUPMAP MODIFY</title>
 638
 639 <para>Update en existing group entry</para>
 640
 641 <para>net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] [comment=string] [type={domain|local}]</para>
 642 </refsect3>
 643
 644 <refsect3>
 645 <title>GROUPMAP LIST</title>
 646
 647 <para>List existing group mapping entries</para>
 648
 649 <para>net groupmap list [verbose] [ntgroup=string] [sid=SID]</para>
 650
 651 </refsect3>
 652 </refsect2>
 653
 654
 655
 656 <refsect2>
 657 <title>MAXRID</title>
 658
 659 <para>Prints out the highest RID currently in use on the local
 660 server (by the active 'passdb backend').
 661 </para>
 662
 663 </refsect2>
 664
 665 <refsect2>
 666 <title>RPC INFO</title>
 667
 668 <para>Print information about the domain of the remote server,
 669 such as domain name, domain sid and number of users and groups.
 670 </para>
 671
 672 </refsect2>
 673
 674 <refsect2>
 675 <title>[RPC|ADS] TESTJOIN</title>
 676
 677 <para>Check whether participation in a domain is still valid.</para>
 678
 679 </refsect2>
 680
 681 <refsect2>
 682 <title>[RPC|ADS] CHANGETRUSTPW</title>
 683
 684 <para>Force change of domain trust password.</para>
 685
 686 </refsect2>
 687
 688 <refsect2>
 689 <title>RPC TRUSTDOM</title>
 690
 691 <refsect3>
 692 <title>RPC TRUSTDOM ADD <replaceable>DOMAIN</replaceable></title>
 693
 694 <para>Add a interdomain trust account for
 695 <replaceable>DOMAIN</replaceable> to the remote server.
 696 </para>
 697
 698 </refsect3>
 699
 700 <refsect3>
 701 <title>RPC TRUSTDOM DEL <replaceable>DOMAIM</replaceable></title>
 702
 703 <para>Remove interdomain trust account for
 704 <replaceable>DOMAIN</replaceable> from the remote server.
 705 </para>
 706
 707 &not.implemented;
 708
 709 </refsect3>
 710
 711 <refsect3>
 712 <title>RPC TRUSTDOM ESTABLISH <replaceable>DOMAIN</replaceable></title>
 713
 714 <para>
 715 Establish a trust relationship to a trusting domain.
 716 Interdomain account must already be created on the remote PDC.
 717 </para>
 718
 719 </refsect3>
 720
 721 <refsect3>
 722 <title>RPC TRUSTDOM REVOKE <replaceable>DOMAIN</replaceable></title>
 723 <para>Abandon relationship to trusted domain</para>
 724
 725 </refsect3>
 726
 727 <refsect3>
 728 <title>RPC TRUSTDOM LIST</title>
 729
 730 <para>List all current interdomain trust relationships.</para>
 731
 732 </refsect3>
 733
 734 <refsect3>
 735 <title>RPC RIGHTS</title>
 736
 737 <para>This subcommand is used to view and manage Samba's rights assignments (also
 738 referred to as privileges).  There are three options current available:
 739 <parameter>list</parameter>, <parameter>grant</parameter>, and
 740 <parameter>revoke</parameter>.  More details on Samba's privilege model and its use
 741 can be found in the Samba-HOWTO-Collection.</para>
 742
 743 </refsect3>
 744
 745
 746 </refsect2>
 747
 748 <refsect2>
 749 <title>RPC ABORTSHUTDOWN</title>
 750
 751 <para>Abort the shutdown of a remote server.</para>
 752
 753 </refsect2>
 754
 755 <refsect2>
 756 <title>SHUTDOWN [-t timeout] [-r] [-f] [-C message]</title>
 757
 758 <para>Shut down the remote server.</para>
 759
 760 <variablelist>
 761 <varlistentry>
 762 <term>-r</term>
 763 <listitem><para>
 764 Reboot after shutdown.
 765 </para></listitem>
 766 </varlistentry>
 767
 768 <varlistentry>
 769 <term>-f</term>
 770 <listitem><para>
 771 Force shutting down all applications.
 772 </para></listitem>
 773 </varlistentry>
 774
 775 <varlistentry>
 776 <term>-t timeout</term>
 777 <listitem><para>
 778 Timeout before system will be shut down. An interactive
 779 user of the system can use this time to cancel the shutdown.
 780 </para></listitem>
 781 </varlistentry>'>
 782
 783 <varlistentry>
 784 <term>-C message</term>
 785 <listitem><para>Display the specified message on the screen to
 786 announce the shutdown.</para></listitem>
 787 </varlistentry>
 788 </variablelist>
 789
 790 </refsect2>
 791
 792 <refsect2>
 793 <title>SAMDUMP</title>
 794
 795 <para>Print out sam database of remote server. You need
 796 to run this on either a BDC. <!--
 797 Is that correct? - Jelmer --></para>
 798 </refsect2>
 799
 800 <refsect2>
 801 <title>VAMPIRE</title>
 802
 803 <para>Export users, aliases and groups from remote server to
 804 local server. Can only be run an a BDC.
 805 </para>
 806
 807 </refsect2>
 808
 809 <refsect2>
 810 <title>GETSID</title>
 811
 812 <para>Fetch domain SID and store it in the local <filename>secrets.tdb</filename>. </para>
 813
 814 </refsect2>
 815
 816 <refsect2>
 817 <title>ADS LEAVE</title>
 818
 819 <para>Make the remote host leave the domain it is part of. </para>
 820
 821 </refsect2>
 822
 823 <refsect2>
 824 <title>ADS STATUS</title>
 825
 826 <para>Print out status of machine account of the local machine in ADS.
 827 Prints out quite some debug info. Aimed at developers, regular
 828 users should use <command>NET ADS TESTJOIN</command>.</para>
 829
 830 </refsect2>
 831
 832 <refsect2>
 833 <title>ADS PRINTER</title>
 834
 835 <refsect3>
 836 <title>ADS PRINTER INFO [<replaceable>PRINTER</replaceable>] [<replaceable>SERVER</replaceable>]</title>
 837
 838 <para>
 839 Lookup info for <replaceable>PRINTER</replaceable> on <replaceable>SERVER</replaceable>. The printer name defaults to "*", the
 840 server name defaults to the local host.</para>
 841
 842 </refsect3>
 843
 844 <refsect3>
 845 <title>ADS PRINTER PUBLISH <replaceable>PRINTER</replaceable></title>
 846
 847 <para>Publish specified printer using ADS.</para>
 848
 849 </refsect3>
 850
 851 <refsect3>
 852 <title>ADS PRINTER REMOVE <replaceable>PRINTER</replaceable></title>
 853
 854 <para>Remove specified printer from ADS directory.</para>
 855
 856 </refsect3>
 857
 858 </refsect2>
 859
 860 <refsect2>
 861 <title>ADS SEARCH <replaceable>EXPRESSION</replaceable> <replaceable>ATTRIBUTES...</replaceable></title>
 862
 863 <para>Perform a raw LDAP search on a ADS server and dump the results. The
 864 expression is a standard LDAP search expression, and the
 865 attributes are a list of LDAP fields to show in the results.</para>
 866
 867 <para>Example: <userinput>net ads search '(objectCategory=group)' sAMAccountName</userinput>
 868 </para>
 869
 870 </refsect2>
 871
 872 <refsect2>
 873 <title>ADS DN <replaceable>DN</replaceable> <replaceable>(attributes)</replaceable></title>
 874
 875 <para>
 876 Perform a raw LDAP search on a ADS server and dump the results. The
 877 DN standard LDAP DN, and the attributes are a list of LDAP fields
 878 to show in the result.
 879 </para>
 880
 881 <para>Example: <userinput>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</userinput></para>
 882
 883 </refsect2>
 884
 885 <refsect2>
 886 <title>WORKGROUP</title>
 887
 888 <para>Print out workgroup name for specified kerberos realm.</para>
 889
 890 </refsect2>
 891
 892
 893 <refsect2>
 894 <title>HELP [COMMAND]</title>
 895
 896 <para>Gives usage information for the specified command.</para>
 897
 898 </refsect2>
 899
 900 </refsect1>
 901
 902 <refsect1>
 903         <title>VERSION</title>
 904
 905         <para>This man page is complete for version 3.0 of the Samba
 906         suite.</para>
 907 </refsect1>
 908
 909 <refsect1>
 910         <title>AUTHOR</title>
 911
 912         <para>The original Samba software and related utilities
 913         were created by Andrew Tridgell. Samba is now developed
 914         by the Samba Team as an Open Source project similar
 915         to the way the Linux kernel is developed.</para>
 916
 917         <para>The net manpage was written by Jelmer Vernooij.</para>
 918
 919 </refsect1>
 920
 921 </refentry>