Provided by: libsmbclient_3.0.28a-1ubuntu4_i386 bug

NAME

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

SYNOPSIS

       Browser                                                         URL:.PP
        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.browse_max_lmb_count). 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.

       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  .smb 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.

PROGRAMMERS 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.

                                                               LIBSMBCLIENT(7)