1
2
.\" Title: libsmbclient
2
3
.\" Author: [see the "AUTHOR" section]
3
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
4
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
6
7
.\" Source: Samba 3.4
7
8
.\" Language: English
9
.TH "LIBSMBCLIENT" "7" "10/29/2009" "Samba 3\&.4" "7"
10
.\" -----------------------------------------------------------------
11
.\" * (re)Define some macros
12
.\" -----------------------------------------------------------------
13
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14
.\" toupper - uppercase a string (locale-aware)
15
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
19
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
21
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22
.\" SH-xref - format a cross-reference to an SH section
23
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33
.\" SH - level-one heading that works better for non-TTY output
34
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
42
.nr an-prevailing-indent \\n[IN]
46
.HTML-TAG ".NH \\n[an-level]"
48
.nr an-no-space-flag 1
54
.\" if n (TTY output), use uppercase
59
.\" if not n (not TTY), use normal case (not uppercase)
63
.\" if not n (not TTY), put a border/line under subheading
68
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
69
.\" SS - level-two heading that works better for non-TTY output
70
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
75
.nr an-prevailing-indent \\n[IN]
80
.nr an-no-space-flag 1
88
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
89
.\" BB/BE - put background/screen (filled box) around block of text
90
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
103
.if "\\$2"adjust-for-leading-newline" \{\
111
.nr BW \\n(.lu-\\n(.i
114
.ie "\\$2"adjust-for-leading-newline" \{\
115
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
118
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
129
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
130
.\" BM/EM - put colored marker in margin next to block of text
131
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
148
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
10
.TH "LIBSMBCLIENT" "7" "01/18/2010" "Samba 3\&.4" "7"
156
11
.\" -----------------------------------------------------------------
157
12
.\" * set default formatting
158
13
.\" -----------------------------------------------------------------
163
18
.\" -----------------------------------------------------------------
164
19
.\" * MAIN CONTENT STARTS HERE *
165
20
.\" -----------------------------------------------------------------
167
22
libsmbclient \- An extension library for browsers and that can be used as a generic browsing API\&.
173
\FCsmb://[[[domain:]user[:password@]]server[/share[/path[/file]]]] [?options] \F[]
27
smb://[[[domain:]user[:password@]]server[/share[/path[/file]]]] [?options]
177
30
This tool is part of the
183
36
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\&.
187
40
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\&.
194
47
Shows all workgroups or domains that are visible in the network\&. The behavior matches that of the Microsoft Windows Explorer\&.
196
49
The method of locating the list of workgroups (domains also) varies depending on the setting of the context variable
197
\FC(context\->options\&.browse_max_lmb_count)\F[]\&. 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\&.
50
(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\&.
205
58
When libsmbclient is invoked by an application it searches for a directory called
207
60
in the $HOME directory that is specified in the users shell environment\&. It then searches for a file called
209
62
which, if present, will fully over\-ride the system
210
\FC/etc/samba/smb\&.conf\F[]
211
64
file\&. If instead libsmbclient finds a file called
212
\FC~/\&.smb/smb\&.conf\&.append\F[], it will read the system
213
\FC/etc/samba/smb\&.conf\F[]
65
~/\&.smb/smb\&.conf\&.append, it will read the system
214
67
and then append the contents of the
215
\FC~/\&.smb/smb\&.conf\&.append\F[]
68
~/\&.smb/smb\&.conf\&.append
220
73
will check the users shell environment for the
222
75
parameter and will use its value when if the
224
77
parameter was not included in the URL\&.
225
78
.SH "PROGRAMMERS GUIDE"