preparing for release of 2.0.4b
[Samba/gbeck.git] / docs / manpages / smbsh.1
blobdbfe92e4c33869118a27055110e28888396b0993
1 .TH SMBSH 1 "20 May 1999" "smbsh 2.0.4b"
2 .PP 
3 .SH "NAME" 
4 smbsh \- Allows access to Windows NT filesystem using UNIX commands
5 .PP 
6 .SH "SYNOPSIS" 
7 .PP 
8 \fBsmbsh\fP
9 .PP 
10 .SH "DESCRIPTION" 
11 .PP 
12 This program is part of the \fBSamba\fP suite\&.
13 .PP 
14 \fBsmbsh\fP allows you to access an NT filesystem using UNIX commands
15 such as \fBls\fP, \fBegrep\fP, and \fBrcp\fP\&. You must use a shell that
16 is dynmanically linked in order for \fBsmbsh\fP to work correctly\&.
17 .PP 
18 To use the \fBsmbsh\fP command, execute \fBsmbsh\fP from the prompt and
19 enter the username and password that authenticate you to the
20 machine running the Windows NT operating system\&.
21 .PP 
23 .DS 
26 system% smbsh
27 Username: user
28 Password:
30 .DE 
33 .PP 
34 Any dynamically linked command you execute from this shell will
35 access the \fB/smb\fP directory using the smb protocol\&.
36 For example, the command 
37 .PP 
38 \f(CWls /smb\fP
39 .PP 
40 will show all the machines in your workgroup\&.
41 The command 
42 .PP 
43 \f(CWls /smb/<machine-name>\fP
44 .PP 
45 will show the share names for that machine\&. You could then, for example, use the 
46 \fBcd\fP command to change directories, \fBvi\fP to edit files, and \fBrcp\fP
47 to copy files\&.
48 .PP 
49 .SH "VERSION" 
50 .PP 
51 This man page is correct for the 2\&.0\&.3 of the Samba suite\&.
52 .PP 
53 .SH "BUGS" 
54 .PP 
55 \fBsmbsh\fP works by intercepting the standard libc calls with the dynamically loaded
56 versions in \fBsmbwrapper\&.o\fP\&. Not all calls have been "wrapped" so some programs
57 may not function correctly under \fBsmbsh\fP\&.
58 .PP 
59 Programs which are not dynamically linked cannot make use of \fBsmbsh\fP\'s 
60 functionality\&. Most versions of UNIX have a \fBfile\fP command that will describe how
61 a program was linked\&.
62 .PP 
63 .SH "SEE ALSO" 
64 .PP 
65 \fBsmb\&.conf (5)\fP,
66 \fBsmbd (8)\fP\&.
67 .PP 
68 .SH "AUTHOR" 
69 .PP 
70 The original Samba software and related utilities were created by
71 Andrew Tridgell (samba-bugs@samba\&.org)\&. Samba is now developed
72 by the Samba Team as an Open Source project similar to the way the
73 Linux kernel is developed\&.
74 .PP 
75 The original Samba man pages were written by Karl Auer\&. The man page
76 sources were converted to YODL format (another excellent piece of Open
77 Source software, available at
78 \fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
79 and updated for the Samba2\&.0 release by Jeremy Allison\&.
80 \fIsamba-bugs@samba\&.org\fP\&.
81 .PP 
82 See \fBsamba (7)\fP to find out how to get a full
83 list of contributors and details on how to submit bug reports,
84 comments etc\&.
85 .PP