docs/manpages/smbsh.1

   1 .\" This manpage has been automatically generated by docbook2man-spec
   2 .\" from a DocBook document.  docbook2man-spec can be found at:
   3 .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
   4 .\" Please send any bug reports, improvements, comments, patches,
   5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6 .TH "SMBSH" "1" "10 October 2001" "" ""
   7 .SH NAME
   8 smbsh \- Allows access to Windows NT filesystem  using UNIX commands
   9 .SH SYNOPSIS
  10 .sp
  11 \fBsmbsh\fR
  12 .SH "DESCRIPTION"
  13 .PP
  14 This tool is part of the  Sambasuite.
  15 .PP
  16 \fBsmbsh\fR allows you to access an NT filesystem
  17 using UNIX commands such as \fBls\fR, \fB egrep\fR, and \fBrcp\fR. You must use a
  18 shell that is dynamically linked in order for \fBsmbsh\fR
  19 to work correctly.
  20 .PP
  21 To use the \fBsmbsh\fR command, execute \fB smbsh\fR from the prompt and enter the username and password
  22 that authenticates you to the machine running the Windows NT
  23 operating system.
  24 .PP
  25 .sp
  26 .nf
  27         system% \fBsmbsh\fR
  28         Username: \fBuser\fR
  29         Password: \fBXXXXXXX\fR
  30
  31 .sp
  32 .fi
  33 .PP
  34 Any dynamically linked command you execute from
  35 this shell will access the \fI/smb\fR directory
  36 using the smb protocol. For example, the command \fBls /smb
  37 \fRwill show a list of workgroups. The command
  38 \fBls /smb/MYGROUP \fR will show all the machines in
  39 the workgroup MYGROUP. The command
  40 \fBls /smb/MYGROUP/<machine-name>\fR will show the share
  41 names for that machine. You could then, for example, use the \fB cd\fR command to change directories, \fBvi\fR to
  42 edit files, and \fBrcp\fR to copy files.
  43 .SH "VERSION"
  44 .PP
  45 This man page is correct for version 2.2 of
  46 the Samba suite.
  47 .SH "BUGS"
  48 .PP
  49 \fBsmbsh\fR works by intercepting the standard
  50 libc calls with the dynamically loaded versions in \fI smbwrapper.o\fR. Not all calls have been "wrapped", so
  51 some programs may not function correctly under \fBsmbsh
  52 \fR\&.
  53 .PP
  54 Programs which are not dynamically linked cannot make
  55 use of \fBsmbsh\fR's functionality. Most versions
  56 of UNIX have a \fBfile\fR command that will
  57 describe how a program was linked.
  58 .SH "SEE ALSO"
  59 .PP
  60 \fBsmbd(8)\fR,
  61 smb.conf(5)
  62 .SH "AUTHOR"
  63 .PP
  64 The original Samba software and related utilities
  65 were created by Andrew Tridgell. Samba is now developed
  66 by the Samba Team as an Open Source project similar
  67 to the way the Linux kernel is developed.
  68 .PP
  69 The original Samba man pages were written by Karl Auer.
  70 The man page sources were converted to YODL format (another
  71 excellent piece of Open Source software, available at
  72 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
  73 release by Jeremy Allison. The conversion to DocBook for
  74 Samba 2.2 was done by Gerald Carter