Index Index for
Section 7
Index Alphabetical
listing for L
Bottom of page Bottom of
page		 

LIBSMBCLIENT(7)


NAME

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


SYNOPSIS

  Browser URL:

  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	 max-
       imum  number  of	 local master browsers to query for the list of work-
       groups. 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 en-
  vironment. 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 pro-
  ject similar to the way the Linux kernel is developed.

  The libsmbclient manpage page was written by John H Terpstra.

Index Index for
Section 7
Index Alphabetical
listing for L
Top of page Top of
page