documented -W option
[ira/wip.git] / docs / manpages / smbclient.1
1 .TH SMBCLIENT 1 17/1/1995 smbclient smbclient
2 .SH NAME
3 smbclient \- ftp-like Lan Manager client program
4 .SH SYNOPSIS
5 .B smbclient
6 .B servicename
7 [
8 .B password
9 ] [
10 .B -A
11 ] [
12 .B -E
13 ] [
14 .B -L
15 .I host
16 ] [
17 .B -M
18 .I host
19 ] [
20 .B -I
21 .I IP number
22 ] [
23 .B -N
24 ] [
25 .B -P
26 ] [
27 .B -U
28 .I username
29 ] [
30 .B -d
31 .I debuglevel
32 ] [
33 .B -l
34 .I log basename
35 ] [
36 .B -n
37 .I netbios name
38 ] [
39 .B -W
40 .I workgroup
41 ] [
42 .B -O
43 .I socket options
44 ] [
45 .B -p
46 .I port number
47 .B -T
48 .I tar options
49 .B -D
50 .I initial directory
51 ]
52 .SH DESCRIPTION
53 This program is part of the Samba suite.
54
55 .B smbclient
56 is a client that can 'talk' to a Lan Manager server. It offers
57 an interface similar to that of the 
58 .B ftp
59 program (see
60 .B ftp(1)). Operations include things like getting files from the
61 server to the local machine, putting files from the local machine to
62 the server, retrieving directory information from the server and so on.
63
64 .SH OPTIONS
65 .B servicename
66 .RS 3
67 .B servicename
68 is the name of the service you want to use on the server. A service
69 name takes the form
70 .B "\\\\\\\\server\\\\service"
71 where
72 .B server
73 is the netbios name of the Lan Manager server offering the desired service and
74 .B service
75 is the name of the service offered. Thus to connect to the service "printer" 
76 on the Lan Manager server "lanman", you would use the servicename
77
78 .RS 10
79 .B "\\\\\\\\lanman\\\\printer"
80 .RE
81
82 Note that the server name required is NOT necessarily the host name of the
83 server! The name required is a Lan Manager server name, which may or may not
84 be the same as the hostname of the machine running the server.
85 .RE
86
87 .B password
88 .RS 3
89 .B
90 password
91 is the password required to access the specified service on the
92 specified server. If supplied, the
93 .B -N
94 option (suppress password prompt) is assumed.
95
96 There is no default password. If no password is supplied on the command line
97 (either here or using the 
98 .B -U
99 option (see below)) and 
100 .B -N
101 is not specified, the client will prompt for a password, even if the desired 
102 service does not require one. (If prompted for a password and none is 
103 required, simply press ENTER to provide a null password.)
104
105 Note: Some servers (including OS/2 and Windows for Workgroups) insist
106 on an uppercase password. Lowercase or mixed case passwords may be
107 rejected by these servers.
108
109 Be cautious about including passwords in scripts.
110 .RE
111
112 .B -A
113
114 .RS 3
115 This parameter, if specified, causes the maximum debug level to be selected.
116 Be warned that this generates prodigious amounts of debug data. There is also
117 a security issue involved, as at the maximum debug level cleartext passwords
118 may be written to some log files.
119 .RE
120
121 .B -L
122
123 .RS 3
124 This option allows you to look at what services are available on a
125 server. You use it as "smbclient -L host" and a list should appear.
126 The -I option may be useful if your netbios names don't match your 
127 tcp/ip host names or if you are trying to reach a host on another
128 network. For example:
129
130 smbclient -L ftp -I ftp.microsoft.com
131
132 will list the shares available on microsofts public server.
133 .RE
134
135 .B -M
136
137 .RS 3
138 This options allows you to send messages, using the "WinPopup"
139 protocol, to another computer. Once a connection is established you
140 then type your message, pressing ^D (control-D) to end.
141
142 If the receiving computer is running WinPopup the user will receive
143 the message and probably a beep. If they are not running WinPopup the
144 message will be lost, and no error message will occur.
145
146 The message is also automatically truncated if the message is over
147 1600 bytes, as this is the limit of the protocol.
148
149 One useful trick is to cat the message through smbclient. For example:
150
151 cat mymessage.txt | smbclient -M FRED
152
153 will send the message in the file "mymessage.txt" to the machine FRED.
154
155 You may also find the -U and -I options useful, as they allow you to
156 control the FROM and TO parts of the message. 
157
158 Samba currently has no way of receiving WinPopup messages.
159
160 Note: Copy WinPopup into the startup group on your WfWg PCs if you
161 want them to always be able to receive messages.
162 .RE
163
164 .B -E
165
166 .RS 3
167 This parameter, if specified, causes the client to write messages to the
168 standard error stream (stderr) rather than to the standard output stream.
169
170 By default, the client writes messages to standard output - typically the
171 user's tty.
172 .RE
173
174 .B -I
175 .I IP number
176
177 .RS 3
178 .I IP number
179 represents the IP number of the server to connect to. It should
180 be specified in standard "a.b.c.d" notation.
181
182 Normally the client will attempt to locate the specified Lan Manager server
183 by looking it up - that is, broadcasting a request for the given server to
184 identify itself. Using this parameter will force the client to assume that
185 the server is on the machine with the specified IP number.
186
187 There is no default for this parameter. If not supplied, it will be determined
188 automatically by the client as described above.
189 .RE
190
191 .B -N
192
193 .RS 3
194 If specified, this parameter suppresses the normal password prompt from the
195 client to the user. This is useful when accessing a service that does not
196 require a password.
197
198 Unless a password is specified on the command line or this parameter is
199 specified, the client will request a password.
200 .RE
201
202 .B -O
203 .I socket options
204 .RS 3
205
206 See the socket options section of smb.conf(5) for details
207
208 .RE
209 .B -P
210
211 .RS 3
212 If specified, the service requested will be connected to as a printer service
213 rather than as a normal filespace service. Operations such as put and get
214 will not be applicable for such a connection.
215
216 By default, services will be connected to as NON-printer services.
217 .RE
218
219 .B -U
220 .I username
221
222 .RS 3
223 .I username
224 is the user name that will be used by the client to make a connection,
225 assuming your server is running a protocol that allows for usernames.
226
227 Some servers are fussy about the case of this name, and some insist
228 that it must be a valid netbios name.
229
230 If no 
231 .I username
232 is supplied, it will default to an uppercase version of the 
233 environment variable 
234 .B USER
235 or
236 .B LOGNAME
237 in that order.
238 If no 
239 .I username
240 is supplied and neither environment variable exists the user name will
241 be empty.
242
243 If the service you are connecting to requires a password, it can be supplied
244 using the
245 .B -U
246 option, by appending a percent symbol ("%") then the password to 
247 .I username.
248 For example, to attach to a service as user "fred" with password "secret", you
249 would specify
250 .B -U
251 .I fred%secret
252 on the command line. Note that there are no spaces around the percent symbol.
253
254 If you specify the password as part of
255 .I username
256 then the 
257 .B -N
258 option (suppress password prompt) is assumed.
259
260 If you specify the password as a parameter AND as part of
261 .I username
262 then the password as part of
263 .I username
264 will take precedence. Putting nothing before or nothing after the percent 
265 symbol will cause an empty username or an empty password to be used,
266 respectively.
267
268 Note: Some servers (including OS/2 and Windows for Workgroups) insist
269 on an uppercase password. Lowercase or mixed case passwords may be
270 rejected by these servers.
271
272 Be cautious about including passwords in scripts.
273 .RE
274
275 .B -d
276 .I debuglevel
277 .RS 3
278
279 debuglevel is an integer from 0 to 5.
280
281 The default value if this parameter is not specified is zero.
282
283 The higher this value, the more detail will be logged to the log files about
284 the activities of the client. At level 0, only critical errors and serious 
285 warnings will be logged. Level 1 is a reasonable level for day to day running
286 - it generates a small amount of information about operations carried out.
287
288 Levels above 1 will generate considerable amounts of log data, and should 
289 only be used when investigating a problem. Levels above 3 are designed for 
290 use only by developers and generate HUGE amounts of log data, most of which 
291 is extremely cryptic.
292 .RE
293
294 .B -l
295 .I log basename
296
297 .RS 3
298 If specified,
299 .I log basename
300 specifies a base filename into which operational data from the running client
301 will be logged.
302
303 The default base name is specified at compile time.
304
305 The base name is used to generate actual log file names. For example, if the
306 name specified was "log", the following files would be used for log data:
307
308 .RS 3
309 log.client.debug (containing debugging information)
310
311 log.client.in (containing inbound transaction data)
312
313 log.client.out (containing outbound transaction data)
314 .RE
315
316 The log files generated are never removed by the client.
317 .RE
318 .RE
319
320 .B -n
321 .I netbios name
322
323 .RS 3
324 By default, the client will use the local machine's hostname (in
325 uppercase) as its netbios name. This parameter allows you to override
326 the host name and use whatever netbios name you wish.
327 .RE
328
329 .B -W
330 .I workgroup
331
332 .RS 3
333 Override what workgroup is used for the connection. This may be needed
334 to connect to some servers.
335 .RE
336
337 .B -p
338 .I port number
339 .RS 3
340
341 port number is a positive integer value.
342
343 The default value if this parameter is not specified is 139.
344
345 This number is the port number that will be used when making connections to
346 the server. The standard (well-known) port number for the server is 139, 
347 hence the default.
348
349 This parameter is not normally specified.
350
351 .B -T
352 .I tar options
353 .RS3 
354
355 where tar options are one or more of c,x,I,X,b,g,N or a; used as:
356 .LP
357 smbclient 
358 .B "\\\\\\\\server\\\\share"
359 \-TcxIXbgNa
360 [
361 .IR blocksize
362 ]
363 [
364 .IR newer-file
365 ]
366 .IR tarfile
367 [
368 .IR filenames....
369 ]
370
371 .RS3
372 .B c
373 Create a tar file on UNIX. Must be followed by the name of a tar file,
374 tape device or "-" for standard output. (May be useful to set debugging
375 low (-d0)) to avoid corrupting your tar file if using "-"). Mutually
376 exclusive with the x flag.
377
378 .B x
379 Extract (restore) a local tar file back to a share. Unless the -D
380 option is given, the tar files will be restored from the top level of
381 the share. Must be followed by the name of the tar file, device or "-"
382 for standard input. Mutually exclusive with the c flag.
383
384 .B I
385 Include files and directories. Is the default behaviour when
386 .IR filenames
387 are specified above. Causes tar files to be included in an extract or create
388 (and therefore everything else to be excluded). See example below.
389 Filename globbing does not work for included files for extractions (yet).
390
391 .B X
392 Exclude files and directories. Causes tar files to be excluded from
393 an extract or create. See example below.
394 Filename globbing does not work for excluded files (yet).
395
396 .B b
397 Blocksize. Must be followed by a valid (greater than zero) blocksize.
398 Causes tar file to be written out in blocksize*TBLOCK (usually 512 byte)
399 blocks.
400
401 .B g
402 Incremental. Only back up files that have the archive bit set. Useful
403 only with the c flag.
404
405 .B N
406 Newer than. Must be followed by the name of a file whose date is
407 compared against files found on the share during a create. Only files
408 newer than the file specified are backed up to the tar file. Useful
409 only with the c flag.
410
411 .B a
412 Set archive bit. Causes the archive bit to be reset when a file is backed
413 up. Useful with the g (and c) flags.
414 .LP
415
416 .B Examples
417
418 smbclient \\\\mypc\\myshare "" -N -Tx backup.tar
419
420 Restore from tar file backup.tar into myshare on mypc (no password on share).
421
422 smbclient \\\\mypc\\myshare "" -N -TXx backup.tar users/docs
423
424 Restore everything except users/docs
425
426 smbclient \\\\mypc\\myshare "" -N -Tc backup.tar users/docs
427
428 Create a tar file of the files beneath users/docs.
429
430 .RE
431
432 .B -D
433 .I initial directory
434
435 .RS3 
436
437 Change to initial directory before starting. Probably only of any use
438 with the tar (\-T) option.
439
440
441 .RE
442
443 .SH OPERATIONS
444 Once the client is running, the user is presented with a prompt, "smb: \\>".
445 The backslash ("\\") indicates the current working directory on the server,
446 and will change if the current working directory is changed.
447
448 The prompt indicates that the client is ready and waiting to carry out a user
449 command. Each command is a single word, optionally followed by parameters
450 specific to that command. Command and parameters are space-delimited unless
451 these notes specifically state otherwise. All commands are case-insensitive.
452 Parameters to commands may or may not be case sensitive, depending on the
453 command.
454
455 You can specify file names which have spaces in them by quoting the
456 name with double quotes, for example "a long file name".
457
458 Parameters shown in square brackets (eg., "[parameter]") are optional. If not
459 given, the command will use suitable defaults. Parameters shown in angle
460 brackets (eg., "<parameter>") are required.
461
462 Note that all commands operating on the server are actually performed by
463 issuing a request to the server. Thus the behaviour may vary from server to
464 server, depending on how the server was implemented.
465
466 The commands available are given here in alphabetical order.
467
468 .B ?
469 .RS 3
470 .B Parameters:
471 .RS 3
472 .I [command]
473
474 .RE
475 .B Description:
476 .RS 3
477 If
478 .I command
479 is specified, the
480 .B ?
481 command will display a brief informative message about the specified command.
482
483 If no command is specified, a list of available commands will be displayed.
484 .RE
485 .RE
486
487 .B !
488 .RS 3
489 .B Parameters:
490 .RS 3
491 .I [shell command]
492
493 .RE
494 .B Description:
495 .RS 3
496 If
497 .I shell command
498 is specified, the
499 .B !
500 command will execute a shell locally and run the specified shell command. If
501 no command is specified, a shell will be run.
502 .RE
503 .RE
504
505 .B cd
506 .RS 3
507 .B Parameters:
508 .RS 3
509 .I [directory name]
510
511 .RE
512 .B Description:
513 .RS 3
514 If
515 .I directory name
516 is specified, the current working directory
517 .B on the server
518 will be changed to the directory specified. This operation will fail if for
519 any reason the specified directory is inaccessible.
520
521 If no directory name is specified, the current working directory
522 .B on the server
523 will be reported.
524 .RE
525 .RE
526
527 .B del
528 .RS 3
529 .B Parameters:
530 .RS 3
531 .I <mask>
532
533 .RE
534 .B Description:
535 .RS 3
536 The client will request that the server attempt to delete all files matching
537 .I mask
538 from the current working directory
539 .B on the server.
540 .RE
541 .RE
542
543 .B dir
544 .RS 3
545 .B Parameters:
546 .RS 3
547 .I <mask>
548
549 .RE
550 .B Description:
551 .RS 3
552 A list of the files matching
553 .I mask
554 in the current working directory
555 .B on the server
556 will be retrieved from the server and displayed.
557 .RE
558 .RE
559
560 .B exit
561 .RS 3
562 .B Parameters:
563 .RS 3
564 None.
565
566 .RE
567 .B Description:
568 .RS 3
569 Terminate the connection with the server and exit from the program.
570 .RE
571 .RE
572
573 .B get
574 .RS 3
575 .B Parameters:
576 .RS 3
577 .I <remote file name> [local file name]
578
579 .RE
580 .B Description:
581 .RS 3
582 Copy the file called
583 .I remote file name
584 from the server to the machine running the client. If specified, name the
585 local copy
586 .I local file name.
587 Note that all transfers in smbclient are binary. See also the
588 .B lowercase
589 command.
590 .RE
591 .RE
592
593 .B help
594 .RS 3
595 .B Parameters:
596 .RS 3
597 .I [command]
598
599 .RE
600 .B Description:
601 .RS 3
602 See the
603 .B ?
604 command above.
605 .RE
606 .RE
607
608 .B lcd
609 .RS 3
610 .B Parameters:
611 .RS 3
612 .I [directory name]
613
614 .RE
615 .B Description:
616 .RS 3
617 If
618 .I directory name
619 is specified, the current working directory
620 .B on the local machine
621 will be changed to the directory specified. This operation will fail if for
622 any reason the specified directory is inaccessible.
623
624 If no directory name is specified, the name of the current working directory
625 .B on the local machine
626 will be reported.
627 .RE
628 .RE
629
630 .B lowercase
631 .RS 3
632 .B Parameters:
633 .RS 3
634 None.
635
636 .RE
637 .B Description:
638 .RS 3
639 Toggle lowercasing of filenames for the
640 .B get
641 and
642 .B mget
643 commands.
644
645 When lowercasing is toggled ON, local filenames are converted to lowercase
646 when using the
647 .B get
648 and
649 .B mget
650 commands. This is often useful when copying (say) MSDOS files from a server,
651 because lowercase filenames are the norm on Unix systems.
652 .RE
653 .RE
654
655 .B ls
656 .RS 3
657 .B Parameters:
658 .RS 3
659 .I <mask>
660
661 .RE
662 .B Description:
663 .RS 3
664 See the
665 .B dir
666 command above.
667 .RE
668 .RE
669
670 .B mask
671 .RS 3
672 .B Parameters:
673 .RS 3
674 .I <mask>
675
676 .RE
677 .B Description:
678 .RS 3
679 This command allows the user to set up a mask which will be used during
680 recursive operation of the
681 .B mget
682 and
683 .B mput
684 commands.
685
686 The masks specified to the
687 .B mget
688 and
689 .B mput
690 commands act as filters for directories
691 rather than files when recursion is toggled ON.
692
693 The mask specified with the
694 .B mask
695 command is necessary to filter files within those directories. For example,
696 if the mask specified in an
697 .B mget
698 command is "source*"
699 .I and
700 the mask specified with the
701 .B mask
702 command is "*.c"
703 .I and
704 recursion is toggled ON, the
705 .B mget
706 command will retrieve all files matching "*.c" in all directories below
707 and including all directories matching "source*" in the current working 
708 directory.
709
710 Note that the value for
711 .I mask
712 defaults to blank (equivalent to "*") and remains so until the
713 .B mask
714 command is used to change it. It retains the most recently specified value
715 indefinitely. To avoid unexpected results it would be wise to change the
716 value of
717 .I mask
718 back to "*" after using the
719 .B mget
720 or
721 .B mput
722 commands.
723 .RE
724 .RE
725
726 .B md
727 .RS 3
728 .B Parameters:
729 .RS 3
730 .I <directory name>
731
732 .RE
733 .B Description:
734 .RS 3
735 See the
736 .B mkdir
737 command.
738 .RE
739 .RE
740
741 .B mget
742 .RS 3
743 .B Parameters:
744 .RS 3
745 .I <mask>
746
747 .RE
748 .B Description:
749 .RS 3
750 Copy all files matching
751 .I mask
752 from the server to the machine running the client.
753
754 Note that
755 .I mask
756 is interpreted differently during recursive operation and non-recursive
757 operation - refer to the
758 .B recurse
759 and
760 .B mask
761 commands for more information. Note that all transfers in smbclient are 
762 binary. See also the
763 .B lowercase
764 command.
765 .RE
766 .RE
767
768 .B mkdir
769 .RS 3
770 .B Parameters:
771 .RS 3
772 .I <directory name>
773
774 .RE
775 .B Description:
776 .RS 3
777 Create a new directory 
778 .B on the server
779 (user access privileges permitting) with the specified name.
780 .RE
781 .RE
782
783 .B mput
784 .RS 3
785 .B Parameters:
786 .RS 3
787 .I <mask>
788
789 .RE
790 .B Description:
791 .RS 3
792 Copy all files matching
793 .I mask
794 in the current working directory
795 .B on the local machine
796 to the current working directory on the server.
797
798 Note that
799 .I mask
800 is interpreted differently during recursive operation and non-recursive
801 operation - refer to the
802 .B recurse
803 and
804 .B mask
805 commands for more information. Note that all transfers in smbclient are 
806 binary.
807 .RE
808 .RE
809
810 .B print
811 .RS 3
812 .B Parameters:
813 .RS 3
814 .I <file name>
815
816 .RE
817 .B Description:
818 .RS 3
819 Print the specified file
820 .B from the local machine
821 through a printable service on the server.
822
823 See also the
824 .B printmode
825 command.
826 .RE
827 .RE
828
829 .B printmode
830 .RS 3
831 .B Parameters:
832 .RS 3
833 .I <graphics or text>
834
835 .RE
836 .B Description:
837 .RS 3
838 Set the print mode to suit either binary data (such as graphical information)
839 or text. Subsequent
840 .B print
841 commands will use the currently set print mode.
842 .RE
843 .RE
844
845 .B prompt
846 .RS 3
847 .B Parameters:
848 .RS 3
849 None.
850
851 .RE
852 .B Description:
853 .RS 3
854 Toggle prompting for filenames during operation of the
855 .B mget
856 and
857 .B mput
858 commands.
859
860 When toggled ON, the user will be prompted to confirm the transfer of each
861 file during these commands. When toggled OFF, all specified files will be
862 transferred without prompting.
863 .RE
864 .RE
865
866 .B put
867 .RS 3
868 .B Parameters:
869 .RS 3
870 .I <local file name> [remote file name]
871
872 .RE
873 .B Description:
874 .RS 3
875 Copy the file called
876 .I local file name
877 from the machine running the client to the server. If specified, name the
878 remote copy
879 .I remote file name.
880 Note that all transfers in smbclient are binary. See also the
881 .B lowercase
882 command.
883 .RE
884 .RE
885
886 .B queue
887 .RS 3
888 .B Parameters:
889 .RS 3
890 None.
891
892 .RE
893 .B Description:
894 .RS 3
895 Displays the print queue, showing the job id, name, size and current status.
896 .RE
897 .RE
898
899 .B quit
900 .RS 3
901 .B Parameters:
902 .RS 3
903 None.
904
905 .RE
906 .B Description:
907 .RS 3
908 See the
909 .B exit
910 command.
911 .RE
912 .RE
913
914 .B rd
915 .RS 3
916 .B Parameters:
917 .RS 3
918 .I <directory name>
919
920 .RE
921 .B Description:
922 .RS 3
923 See the
924 .B rmdir
925 command.
926 .RE
927 .RE
928
929 .B recurse
930 .RS 3
931 .B Parameters:
932 .RS 3
933 None.
934
935 .RE
936 .B Description:
937 .RS 3
938 Toggle directory recursion for the commands
939 .B mget
940 and
941 .B mput
942 .
943
944 When toggled ON, these commands will process all directories in the source
945 directory (ie., the directory they are copying
946 .I from
947 ) and will recurse into any that match the mask specified to the command. Only
948 files that match the mask specified using the
949 .B mask
950 command will be retrieved. See also the
951 .mask
952 command.
953
954 When recursion is toggled OFF, only files from the current working
955 directory on the source machine that match the mask specified to the
956 .B mget
957 or
958 .B mput
959 commands will be copied, and any mask specified using the
960 .B mask
961 command will be ignored.
962 .RE
963 .RE
964
965 .B rm
966 .RS 3
967 .B Parameters:
968 .RS 3
969 .I <mask>
970
971 .RE
972 .B Description:
973 .RS 3
974 Remove all files matching
975 .I mask
976 from the current working directory
977 .B on the server.
978 .RE
979 .RE
980
981 .B rmdir
982 .RS 3
983 .B Parameters:
984 .RS 3
985 .I <directory name>
986
987 .RE
988 .B Description:
989 .RS 3
990 Remove the specified directory (user access privileges permitting)
991 .B from the server.
992 .RE
993 .RE
994
995 .B tar
996 .RS 3
997 .B Parameters:
998 .RS 3
999 .I <c|x>[IXbgNa]
1000
1001 .RE
1002 .B Description:
1003 .RS 3
1004 Performs a tar operation - see -T command line option above. Behaviour
1005 may be affected by the
1006 .B tarmode
1007 command (see below). Using the g (incremental) and N (newer) will affect
1008 tarmode settings. Note that using the "-" option with tar x may not
1009 work - use the command line option instead.
1010 .RE
1011 .RE
1012
1013 .B blocksize
1014 .RS 3
1015 .B Parameters
1016 .RS 3
1017 .I <blocksize>
1018
1019 .RE
1020 .B Description
1021 .RS 3
1022 Blocksize. Must be followed by a valid (greater than zero) blocksize.
1023 Causes tar file to be written out in blocksize*TBLOCK (usually 512 byte)
1024 blocks.
1025 .RE
1026 .RE
1027
1028 .B tarmode
1029 .RS 3
1030 .B Parameters
1031 .RS 3
1032 .I <full|inc|reset|noreset>
1033
1034 .RE
1035 .B Description
1036 .RS 3
1037 Changes tar's behaviour with regard to archive bits. In full mode,
1038 tar will back up everything regardless of the archive bit setting (this
1039 is the default mode). In incremental mode, tar will only back up files
1040 with the archive bit set. In reset mode, tar will reset the archive bit
1041 on all files it backs up (implies read/write share).
1042 .RE
1043 .RE
1044
1045 .B setmode
1046 .RS 3
1047 .B Parameters
1048 .RS 3
1049 .I <filename> <perm=[+|-]rsha>
1050
1051 .RE
1052 .B Description
1053 .RS 3
1054 A version of the DOS attrib command to set file permissions. For example,
1055
1056 setmode myfile +r
1057
1058 would make myfile read only.
1059 .RE
1060 .RE
1061
1062 .SH NOTES
1063 Some servers are fussy about the case of supplied usernames, passwords, share
1064 names (aka service names) and machine names. If you fail to connect try
1065 giving all parameters in uppercase.
1066
1067 It is often necessary to use the
1068 .B -n
1069 option when connecting to some types
1070 of servers. For example OS/2 LanManager insists on a valid netbios name
1071 being used, so you need to supply a valid name that would be known to
1072 the server.
1073
1074 .B smbclient
1075 supports long file names where the server supports the LANMAN2
1076 protocol.
1077
1078 .SH FILES
1079 Not applicable.
1080
1081 .SH ENVIRONMENT VARIABLES
1082 .B USER
1083 .RS 3
1084 The variable USER may contain the username of the person using the client.
1085 This information is used only if the protocol level is high enough to support
1086 session-level passwords.
1087 .RE
1088
1089 .SH INSTALLATION
1090 The location of the client program is a matter for individual system 
1091 administrators. The following are thus suggestions only.
1092
1093 It is recommended that the client software be installed under the /usr/local
1094 hierarchy, in a directory readable by all, writeable only by root. The client
1095 program itself should be executable by all. The client should NOT be setuid 
1096 or setgid!
1097
1098 The client log files should be put in a directory readable and writable only
1099 by the user.
1100
1101 To test the client, you will need to know the name of a running Lan manager
1102 server. It is possible to run the smbd (see
1103 .B smbd(8)) as an ordinary user - running that server as a daemon on a
1104 user-accessible port (typically any port number over 1024) would
1105 provide a suitable test server.
1106 .SH VERSION
1107 This man page is (mostly) correct for version 1.9.00 of the Samba suite, plus some
1108 of the recent patches to it. These notes will necessarily lag behind 
1109 development of the client software, so it is possible that your version of 
1110 the client has extensions or parameter semantics that differ from or are not 
1111 covered by this man page. Please notify these to the address below for 
1112 rectification.
1113 .SH SEE ALSO
1114 .B smbd(8)
1115
1116 .SH DIAGNOSTICS
1117 [This section under construction]
1118
1119 Most diagnostics issued by the client are logged in a specified log file. The
1120 log file name is specified at compile time, but may be overridden on the
1121 command line.
1122
1123 The number and nature of diagnostics available depends on the debug level used
1124 by the client. If you have problems, set the debug level to 3 and peruse the
1125 log files.
1126
1127 Most messages are reasonably self-explanatory. Unfortunately, at time of
1128 creation of this man page the source code is still too fluid to warrant
1129 describing each and every diagnostic. At this stage your best bet is still
1130 to grep the source code and inspect the conditions that gave rise to the 
1131 diagnostics you are seeing.
1132
1133 .SH BUGS
1134 None known.
1135 .SH CREDITS
1136 The original Samba software and related utilities were created by 
1137 Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper
1138 of the Source for this project.
1139
1140 This man page written by Karl Auer (Karl.Auer@anu.edu.au)
1141
1142 See
1143 .B smb.conf(5) for a full list of contributors and details on how to 
1144 submit bug reports, comments etc.