home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / network / smbclient_1 / ReadMe next >
Text File  |  1997-09-02  |  5KB  |  138 lines
  1. Contents
  2. --------
  3.   What can smbclient do for me?
  4.   How do I use it?
  5.   Now I've found a service how do I connect?
  6.   What does smbclient need to work?
  7.   What if it goes wrong? Who can I contact?
  8.   
  9.   
  10.   
  11. What can smbclient do for me?
  12. ------------------------------
  13.   
  14.   smbclient will let you access any shared resources on
  15.   a WfW, Win95, OS/2, or unix box running samba. That is any shared discs
  16.   or printers can be accessed from your RiscPC. You can find out what
  17.   shares are available on a machine. It also allows you to send (but
  18.   not receive) popup messages to PCs.
  19.   
  20.   
  21.   
  22. How do I use it?
  23. ----------------
  24.   This is a short intro on how to use this port of smbclient more information
  25.   can be found in the man page included with this distribution.
  26.   
  27.   smbclient is very similar to ftp, you connect to a machine and then browse
  28.   the remote file system and download or upload files. Unlike ftp you must
  29.   know what service you want before you connect to the machine.
  30.   
  31.   You can find out what shares are available by using the '-L hostname'
  32.   option to list the shares. When connecting to my unix box the smbclient
  33.   shows the following:
  34.   
  35.   I have an internal network not connected to the internet called
  36.   clubs.uk with machines named after Liverpool clubs.
  37.   
  38.   *smbclient -L voodoo.clubs.uk
  39.   myhostname is (wildlife.clubs.uk)
  40.   login name is WILDLIFE
  41.   Server time is Thu Jul  3 19:54:42 1997
  42.   Timezone is UTC+1.0
  43.   Domain=[CLUBBERS] OS=[Unix] Server=[Samba 1.9.15p8]
  44.   login appeared to be ok
  45.   
  46.   Server=[voodoo] User=[simon] Workgroup=[CLUBBERS] Domain=[CLUBBERS]
  47.   server info completed
  48.   
  49.       Sharename      Type      Comment
  50.       ---------      ----      -------
  51.       IPC$           IPC       IPC Service (Samba 1.9.15p8)
  52.       lp             Printer   local line printer
  53.       ps_hi          Printer   Ghostscript (epson9high)
  54.       ps_lo          Printer   Ghostscript (epson)
  55.       public         Disk      Public file space
  56.       simon          Disk      Home Directories
  57.       www            Disk      WWW work space
  58.   
  59.   This machine has a browse list:
  60.   
  61.       Server               Comment
  62.       ---------            -------
  63.       VOODOO               Samba 1.9.15p8
  64.       EASYSTREET           
  65.       UNIT                 Ben Rayner
  66.       CREAM                Aaaargh.....
  67.       GARLANDS             CHARLES MASSEY
  68.   
  69.   
  70.   
  71. Now I've found a service how do I connect?
  72. ------------------------------------------
  73.   
  74.   A quirk of unixlib I guess is that you need to escape all the \'s.
  75.   connecting to a service looks like this:
  76.       smbclient \\\\VOODOO\\public
  77.   
  78.   instead of the normal:
  79.       smbclient \\VOODOO\public
  80.   
  81.   which you would find in the man page included in this archive.
  82.   
  83.   when prompted for a password for a public directory just press enter.
  84.   
  85.   when you connect you will be prompted with the root of this share.
  86.   you can now move about it using 'cd', view directory listings with
  87.   'ls' or 'dir' and move files about just like ftp.
  88.   
  89.   I've had transfer rates of almost 400k/sec for large file transfers
  90.   in a taskwindow on my StrongARM RiscPC from my PC with it's old ISA
  91.   network card.
  92.   
  93.   
  94. What does smbclient need to work?
  95. ---------------------------------
  96.  
  97.   Make sure it has enough memory to work in >500k is best.
  98.   
  99.   You can help it a lot by giving it some hints as to who you want to
  100.   login as. the following environment variables can be set:
  101.   
  102.   Set USER    simon
  103.   Set LOGNAME simon
  104.   These do not need to be the same, in the above example I didn't set LOGNAME
  105.   which defaulted to the hostname of the machine I was connecting from.
  106.   
  107.   The system variable Inet$HostName must be setup, it should be if your
  108.   connecting over a network.
  109.   
  110.   Set PAGER  more
  111.   can be used to display a file, note that more is the default program it
  112.   will try to run.
  113.   
  114.   
  115.   
  116. What if it goes wrong? Who can I contact?
  117. -----------------------------------------
  118.   
  119.   Tell me about bugs and faults within smbclient. I might do something
  120.   about them. I ported this program because I was bored one night and
  121.   got so far that I spent the next 2 evenings finishing off the port.
  122.   contact me if you want the source code.
  123.   
  124.   bug reports and text dumps of sessions should be sent to me via email as
  125.   should requests for my current address, I've just moved (Sept 97).
  126.   
  127.   mailto:simon@bigblue.demon.co.uk
  128.   
  129.   This port of smbclient has only been lightly tested.
  130.   login and password checking looks ok as does get and put for disks
  131.   and put for printers. sending popup messages also works.
  132.   This program was tested on a unix server running samba and several
  133.   Win95 machines.
  134.  
  135. Simon Truss
  136. September 1997
  137. http://java.cms.livjm.ac.uk/digital-d/voodoo.html
  138.