ca52ce8ffc74e7bfe56571eb3fa2b67aac96052d
[kai/samba.git] / docs / docbook / manpages / net.8.sgml
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2 <!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities;
3
4 <!-- This one is only used for adding users using RAP -->
5 <!ENTITY net.arg.flags '
6 <varlistentry>
7 <term>-F flags</term>
8 <listitem><para>
9 FIXME. Defaults to 0x21
10 </para></listitem>
11 </varlistentry>'>
12
13 <!-- This one is only used by shutdown (RPC) -->
14 <!ENTITY net.arg.shutdown '
15 <varlistentry>
16 <term>-r</term>
17 <listitem><para>
18 Reboot after shutdown.
19 </para></listitem>
20 </varlistentry>
21
22 <varlistentry>
23 <term>-f</term>
24 <listitem><para>
25 Force shutting down all applications.
26 </para></listitem>
27 </varlistentry>
28
29 <varlistentry>
30 <term>-t timeout</term>
31 <listitem><para>
32 Timeout before system will be shut down. An interactive 
33 user of the system can use this time to cancel the shutdown.
34 </para></listitem>
35 </varlistentry>'>
36 ]>
37
38 <refentry id="net.8">
39
40 <refmeta>
41         <refentrytitle>net</refentrytitle>
42         <manvolnum>8</manvolnum>
43 </refmeta>
44
45
46 <refnamediv>
47         <refname>net</refname>
48         <refpurpose>Tool for administration of Samba and remote
49         CIFS servers.
50         </refpurpose>
51 </refnamediv>
52
53 <refsynopsisdiv>
54         <cmdsynopsis>
55                 <command>net</command>
56                 <arg choice="req">&lt;ads|rap|rpc&gt;</arg>
57                 <arg choice="opt">-h</arg>
58                 <arg choice="opt">-w workgroup</arg>
59                 <arg choice="opt">-W myworkgroup</arg>
60                 <arg choice="opt">-U user</arg>
61                 <arg choice="opt">-I ip-address</arg>
62                 <arg choice="opt">-p port</arg>
63                 <arg choice="opt">-n myname</arg>
64                 <arg choice="opt">-s conffile</arg>
65                 <arg choice="opt">-S server</arg>
66                 <arg choice="opt">-l</arg>
67                 <arg choice="opt">-P</arg>
68                 <arg choice="opt">-D debuglevel</arg>
69         </cmdsynopsis>
70 </refsynopsisdiv>
71
72 <refsect1>
73         <title>DESCRIPTION</title>
74
75         <para>This tool is part of the <citerefentry><refentrytitle>Samba</refentrytitle>
76         <manvolnum>7</manvolnum></citerefentry> suite.</para>
77
78         <para>The samba net utility is meant to work just like the net utility 
79         available for windows and DOS. The first argument should be used 
80         to specify the protocol to use when executing a certain command. 
81         ADS is used for ActiveDirectory, RAP is using for old (Win9x/NT3) 
82         clients and RPC can be used for NT4 and Windows 2000. If this 
83         argument is omitted, net will try to determine it automatically. 
84         Not all commands are available on all protocols.
85         </para>
86
87 </refsect1>
88
89 <refsect1>
90         <title>OPTIONS</title>
91
92         <variablelist>
93                 &stdarg.help;
94                 
95                 <varlistentry>
96                 <term>-w target-workgroup</term>
97                 <listitem><para>
98                 Sets target workgroup or domain. You have to specify 
99                 either this option or the IP address or the name of a server.
100                 </para></listitem>
101                 </varlistentry>
102
103                 <varlistentry>
104                 <term>-W workgroup</term>
105                 <listitem><para>
106                 Sets client workgroup or domain
107                 </para></listitem>
108                 </varlistentry>
109
110                 <varlistentry>
111                 <term>-U user</term>
112                 <listitem><para>
113                 User name to use
114                 </para></listitem>
115                 </varlistentry>
116
117                 <varlistentry>
118                 <term>-I ip-address</term>
119                 <listitem><para>
120                 IP address of target server to use. You have to
121                 specify either this option or a target workgroup or
122                 a target server.
123                 </para></listitem>
124                 </varlistentry>
125
126                 <varlistentry>
127                 <term>-p port</term>
128                 <listitem><para>
129                 Port on the target server to connect to (usually 139 or 445). 
130                 Defaults to trying 445 first, then 139.
131                 </para></listitem>
132                 </varlistentry>
133
134                 &stdarg.netbios.name;
135                 &stdarg.configfile;
136
137                 <varlistentry>
138                 <term>-S server</term>
139                 <listitem><para>
140                 Name of target server. You should specify either 
141                 this option or a target workgroup or a target IP address.
142                 </para></listitem>
143                 </varlistentry>
144
145                 <varlistentry>
146                 <term>-l</term>
147                 <listitem><para>
148                 When listing data, give more information on each item.
149                 </para></listitem>
150                 </varlistentry>
151
152                 <varlistentry>
153                 <term>-P</term>
154                 <listitem><para>
155                 Make queries to the external server using the machine account of the local server.
156                 </para></listitem>
157                 </varlistentry>
158
159                 &stdarg.debug;
160         </variablelist>
161 </refsect1>
162
163 <refsect1>
164 <title>COMMANDS</title>
165
166 <refsect2>
167         <title>TIME</title>
168
169         <para>The <command>NET TIME</command> command allows you to view the time on a remote server
170         or synchronise the time on the local server with the time on the remote server.</para>
171
172 <refsect3>
173 <title>TIME</title>
174
175 <para>Without any options, the <command>NET TIME</command> command 
176 displays the time on the remote server.
177 </para>
178
179 </refsect3>
180
181 <refsect3>
182 <title>TIME SYSTEM</title>
183
184 <para> Displays the time on the remote server in a format ready for <command>/bin/date</command></para>
185
186 </refsect3>
187
188 <refsect3>
189 <title>TIME SET</title>
190 <para>Tries to set the date and time of the local server to that on 
191 the remote server using <command>/bin/date</command>. </para>
192
193 </refsect3>
194
195 <refsect3>
196 <title>TIME ZONE</title>
197
198 <para>Displays the timezone in hours from GMT on the remote computer.</para>
199
200 </refsect3>
201 </refsect2>
202
203 <refsect2>
204 <title>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [options]</title>
205
206 <para>
207 Join a domain.  If the account already exists on the server, and 
208 [TYPE] is MEMBER, the machine will attempt to join automatically. 
209 (Assuming that the machine has been created in server manager)
210 Otherwise, a password will be prompted for, and a new account may
211 be created.</para>
212
213 <para>
214 [TYPE] may be PDC, BDC or MEMBER to specify the type of server
215 joining the domain.
216 </para>
217 </refsect2>
218
219 <refsect2>
220 <title>[RPC] OLDJOIN [options]</title>
221
222 <para>Join a domain. Use the OLDJOIN option to join the domain 
223 using the old style of domain joining - you need to create a trust 
224 account in server manager first.</para>
225 </refsect2>
226
227 <refsect2>
228 <title>[RPC|ADS] USER</title>
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 LIST</title>
239
240 <para>List all users</para>
241
242 </refsect3>
243
244 <refsect3>
245 <title>[RPC|ADS] USER INFO <replaceable>target</replaceable></title>
246
247 <para>List the domain groups of a the 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>Add a new group mapping entry</para>
636
637 <para>net groupmap add {rid=int|sid=string} unixgroup=string [type={domain|local|builtin}] [ntgroup=string] [comment=string]</para>
638
639 </refsect3>
640
641 <refsect3>
642 <title>GROUPMAP DELETE</title>
643
644 <para>Delete a group mapping entry</para>
645
646 <para>net groupmap delete {ntgroup=string|sid=SID}</para>
647
648 </refsect3>
649
650 <refsect3>
651 <title>GROUPMAP MODIFY</title>
652
653 <para>Update en existing group entry</para>
654
655 <para>net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] [comment=string] [type={domain|local}</para>
656 </refsect3>
657
658 <refsect3>
659 <title>GROUPMAP LIST</title>
660
661 <para>List existing group mapping entries</para>
662
663 <para>net groupmap list [verbose] [ntgroup=string] [sid=SID]</para>
664
665 </refsect3>
666 </refsect2>
667
668
669
670 <refsect2>
671 <title>MAXRID</title>
672
673 <para>Prints out the highest RID currently in use on the local
674 server (by the active 'passdb backend').
675 </para>
676
677 </refsect2>
678
679 <refsect2>
680 <title>RPC INFO</title>
681
682 <para>Print information about the domain of the remote server,
683 such as domain name, domain sid and number of users and groups.
684 </para>
685
686 </refsect2>
687
688 <refsect2>
689 <title>[RPC|ADS] TESTJOIN</title>
690
691 <para>Check whether participation in a domain is still valid.</para>
692
693 </refsect2>
694
695 <refsect2>
696 <title>[RPC|ADS] CHANGETRUSTPW</title>
697
698 <para>Force change of domain trust password.</para>
699
700 </refsect2>
701
702 <refsect2>
703 <title>RPC TRUSTDOM</title>
704
705 <refsect3>
706 <title>RPC TRUSTDOM ADD <replaceable>DOMAIN</replaceable></title>
707
708 <para>Add a interdomain trust account for 
709 <replaceable>DOMAIN</replaceable> to the remote server. 
710 </para>
711
712 </refsect3>
713
714 <refsect3>
715 <title>RPC TRUSTDOM DEL <replaceable>DOMAIM</replaceable></title>
716
717 <para>Remove interdomain trust account for 
718 <replaceable>DOMAIN</replaceable> from the remote server. 
719 </para>
720
721 &not.implemented;
722
723 </refsect3>
724
725 <refsect3>
726 <title>RPC TRUSTDOM ESTABLISH <replaceable>DOMAIN</replaceable></title>
727
728 <para>
729 Establish a trust relationship to a trusting domain. 
730 Interdomain account must already be created on the remote PDC.
731 </para>
732
733 </refsect3>
734
735 <refsect3>
736 <title>RPC TRUSTDOM REVOKE <replaceable>DOMAIN</replaceable></title>
737 <para>Abandon relationship to trusted domain</para>
738
739 </refsect3>
740
741 <refsect3>
742 <title>RPC TRUSTDOM LIST</title>
743
744 <para>List all current interdomain trust relationships.</para>
745
746 </refsect3>
747
748 </refsect2>
749
750 <refsect2>
751 <title>RPC ABORTSHUTDOWN</title>
752
753 <para>Abort the shutdown of a remote server.</para>
754
755 </refsect2>
756
757 <refsect2>
758 <title>SHUTDOWN [-t timeout] [-r] [-f] [-C message]</title>
759
760 <para>Shut down the remote server.</para>
761
762 <variablelist>
763 &net.arg.shutdown;
764 <varlistentry>
765 <term>-C message</term>
766 <listitem><para>Display the specified message on the screen to 
767 announce the shutdown.</para></listitem>
768 </varlistentry>
769 </variablelist>
770
771 </refsect2>
772
773 <refsect2>
774 <title>SAMDUMP</title>
775
776 <para>Print out sam database of remote server. You need
777 to run this on either a BDC. <!-- 
778 Is that correct? - Jelmer --></para>
779 </refsect2>
780
781 <refsect2>
782 <title>VAMPIRE</title>
783
784 <para>Export users, aliases and groups from remote server to 
785 local server. Can only be run an a BDC.
786 </para>
787
788 </refsect2>
789
790 <refsect2>
791 <title>GETSID</title>
792
793 <para>Fetch domain SID and store it in the local <filename>secrets.tdb</filename>. </para>
794
795 </refsect2>
796
797 <refsect2>
798 <title>ADS LEAVE</title>
799
800 <para>Make the remote host leave the domain it is part of. </para>
801
802 </refsect2>
803
804 <refsect2>
805 <title>ADS STATUS</title>
806
807 <para>Print out status of machine account of the local machine in ADS.
808 Prints out quite some debug info. Aimed at developers, regular 
809 users should use <command>NET ADS TESTJOIN</command>.</para>
810
811 </refsect2>
812
813 <refsect2>
814 <title>ADS PRINTER</title>
815
816 <refsect3>
817 <title>ADS PRINTER INFO [<replaceable>PRINTER</replaceable>] [<replaceable>SERVER</replaceable>]</title>
818
819 <para>
820 Lookup info for <replaceable>PRINTER</replaceable> on <replaceable>SERVER</replaceable>. The printer name defaults to "*", the 
821 server name defaults to the local host.</para>
822
823 </refsect3>
824
825 <refsect3>
826 <title>ADS PRINTER PUBLISH <replaceable>PRINTER</replaceable></title>
827
828 <para>Publish specified printer using ADS.</para>
829
830 </refsect3>
831
832 <refsect3>
833 <title>ADS PRINTER REMOVE <replaceable>PRINTER</replaceable></title>
834
835 <para>Remove specified printer from ADS directory.</para>
836
837 </refsect3>
838
839 </refsect2>
840
841 <refsect2>
842 <title>ADS SEARCH <replaceable>EXPRESSION</replaceable> <replaceable>ATTRIBUTES...</replaceable></title>
843
844 <para>Perform a raw LDAP search on a ADS server and dump the results. The 
845 expression is a standard LDAP search expression, and the 
846 attributes are a list of LDAP fields to show in the results.</para>
847
848 <para>Example: <userinput>net ads search '(objectCategory=group)' sAMAccountName</userinput>
849 </para>
850
851 </refsect2>
852
853 <refsect2>
854 <title>ADS DN <replaceable>DN</replaceable> <replaceable>(attributes)</replaceable></title>
855
856 <para>
857 Perform a raw LDAP search on a ADS server and dump the results. The 
858 DN standard LDAP DN, and the attributes are a list of LDAP fields 
859 to show in the result. 
860 </para>
861
862 <para>Example: <userinput>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</userinput></para>
863
864 </refsect2>
865
866 <refsect2>
867 <title>WORKGROUP</title>
868
869 <para>Print out workgroup name for specified kerberos realm.</para>
870
871 </refsect2>
872
873
874 <refsect2>
875 <title>HELP [COMMAND]</title>
876
877 <para>Gives usage information for the specified command.</para>
878
879 </refsect2>
880
881 </refsect1>
882
883 <refsect1>
884         <title>VERSION</title>
885
886         <para>This man page is complete for version 3.0 of the Samba 
887         suite.</para>
888 </refsect1>
889
890 <refsect1>
891         <title>AUTHOR</title>
892         
893         <para>The original Samba software and related utilities 
894         were created by Andrew Tridgell. Samba is now developed
895         by the Samba Team as an Open Source project similar 
896         to the way the Linux kernel is developed.</para>
897
898         <para>The net manpage was written by Jelmer Vernooij.</para>
899         
900 </refsect1>
901
902 </refentry>