7                                                 LIBSMBCLIENT(7)



NAME
     libsmbclient - An extension library for browsers and that
     can be used as a generic browsing API.

SYNOPSIS
     Browser URL:.P
      smb:/[domain:]user[:password@]server[/share[/path[/file]
      [?options]

DESCRIPTION
     This tool is part of the samba(7) suite.

     libsmbclient is a library toolset that permits applications
     to manipulate CIFS/SMB network resources using many of the
     standards POSIX functions available for manipulating local
     UNIX/Linux files. It permits much more than just browsing,
     files can be opened and read or written, permissions
     changed, file times modified, attributes and ACL's can be
     manipulated, and so on. Of course, its functionality
     includes all the capabilities commonly called browsing.

     libsmbclient can not be used directly from the command line,
     instead it provides an extension of the capabilities of
     tools such as file managers and browsers. This man page
     describes the configuration options for this tool so that
     the user may obtain greatest utility of use.

OPTIONS
     What the URLs mean:

     smb:/
         Shows all workgroups or domains that are visible in the
         network. The behavior matches that of the Microsoft
         Windows Explorer.

         The method of locating the list of workgroups (domains
         also) varies depending on the setting of the context
         variable (context->options.browsemaxlmbcount). It is
         the responsibility of the application that calls this
         library to set this to a sensible value. This is a
         compile-time option. This value determines the maximum
         number of local master browsers to query for the list of
         workgroups. In order to ensure that the list is complete
         for those present on the network, all master browsers
         must be querried. If there are a large number of
         workgroups on the network, the time spent querying will
         be significant. For small networks (just a few
         workgroups), it is suggested to set this value to 0,
         instructing libsmbclient to query all local master
         browsers. In an environment that has many workgroups a
         more reasonable setting may be around 3.




Samba 3.0            Last change: 01/19/2009                    1






7                                                 LIBSMBCLIENT(7)



     smb:/name/
         This command causes libsmbclient to perform a name
         look-up. If the NAME<1D> or NAME<1B> exists (workgroup
         name), libsmbclient will list all servers in the
         workgroup (or domain). Otherwise, a name look-up for the
         NAME<20> (machine name) will be performed, and the list
         of shared resources on the server will be displayed.

     When libsmbclient is invoked by an application it searches
     for a directory called in the $HOME directory that is
     specified in the users shell environment. It then searches
     for a file called smb.conf which, if present, will fully
     over-ride the system /etc/samba/smb.conf file. If instead
     libsmbclient finds a file called ~/.smb/smb.conf.append, it
     will read the system /etc/samba/smb.conf and then append the
     contents of the ~/.smb/smb.conf.append to it.

     libsmbclient will check the users shell environment for the
     USER parameter and will use its value when if the user
     parameter was not included in the URL.

PROGRAMERS GUIDE
     Watch this space for future updates.

VERSION
     This man page is correct for version 3.0 of the Samba suite.

AUTHOR
     The original Samba software and related utilities were
     created by Andrew Tridgell. Samba is now developed by the
     Samba Team as an Open Source project similar to the way the
     Linux kernel is developed.

     The libsmbclient manpage page was written by John H
     Terpstra.

ATRIBUTES
     See attributes(5) for descriptions of the following
     attributes:

     
       ATRIBUTE TYPE       ATRIBUTE VALUE   
    
     Availability         SUNWsmbar, SUNWsmbau
    
     Interface Stability  External            
    

NOTES
     Source for Samba is available on http:/opensolaris.org.

     Samba(7) delivers the set of four SMF(5) services as can be



Samba 3.0            Last change: 01/19/2009                    2






7                                                 LIBSMBCLIENT(7)



     seen from the following example:

          $ svcs samba wins winbind swat
         STATE          STIME    FMRI
         disabled       Apr21   svc:/network/samba:default
         disabled       Apr21   svc:/network/winbind:default
         disabled       Apr21   svc:/network/wins:default
         disabled       Apr21   svc:/network/swat:default

     where the services are:

      "samba"
         runs the smbd daemon managing the CIFS sessions

      "wins"
         runs the nmbd daemon enabling the browsing (WINS)

      "winbind"
         runs the winbindd daemon making the domain idmap

      "swat"
         Samba Web Administration Tool is a service providing
         access to browser-based Samba administration interface
         and on-line documentation.  The service runs on software
         loopback network interface on port 901/tcp, i.e. opening
         "http:/localhost:901/" in browser will access the SWAT
         service on local machine.

     Please note: SWAT uses HTP Basic Authentication scheme
     where user name and passwords are sent over the network in
     clear text. In the SWAT case the user name is root.
     Transferring such sensitive data is advisable only on the
     software loopback network interface or over secure networks.






















Samba 3.0            Last change: 01/19/2009                    3