source: vendor/current/docs/manpages/vfstest.1@ 746

Last change on this file since 746 was 746, checked in by Silvan Scherrer, 13 years ago

Samba Server: updated vendor to 3.6.9
File size: 8.5 KB
Line 
1'\" t
2.\" Title: vfstest
3.\" Author: [see the "AUTHOR" section]
4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5.\" Date: 10/29/2012
6.\" Manual: User Commands
7.\" Source: Samba 3.6
8.\" Language: English
9.\"
10.TH "VFSTEST" "1" "10/29/2012" "Samba 3\&.6" "User Commands"
11.\" -----------------------------------------------------------------
12.\" * set default formatting
13.\" -----------------------------------------------------------------
14.\" disable hyphenation
15.nh
16.\" disable justification (adjust text to left margin only)
17.ad l
18.\" -----------------------------------------------------------------
19.\" * MAIN CONTENT STARTS HERE *
20.\" -----------------------------------------------------------------
21.SH "NAME"
22vfstest \- tool for testing samba VFS modules
23.SH "SYNOPSIS"
24.HP \w'\ 'u
25vfstest [\-d\ debuglevel] [\-c\ command] [\-l\ logdir] [\-h]
26.SH "DESCRIPTION"
27.PP
28This tool is part of the
29\fBsamba\fR(7)
30suite\&.
31.PP
32vfstest
33is a small command line utility that has the ability to test dso samba VFS modules\&. It gives the user the ability to call the various VFS functions manually and supports cascaded VFS modules\&.
34.SH "OPTIONS"
35.PP
36\-c|\-\-command=command
37.RS 4
38Execute the specified (colon\-separated) commands\&. See below for the commands that are available\&.
39.RE
40.PP
41\-h|\-\-help
42.RS 4
43Print a summary of command line options\&.
44.RE
45.PP
46\-l|\-\-logfile=logbasename
47.RS 4
48File name for log/debug files\&. The extension
49\fB\'\&.client\'\fR
50will be appended\&. The log file is never removed by the client\&.
51.RE
52.PP
53\-d|\-\-debuglevel=level
54.RS 4
55\fIlevel\fR
56is an integer from 0 to 10\&. The default value if this parameter is not specified is 0\&.
57.sp
58The higher this value, the more detail will be logged to the log files about the activities of the server\&. At level 0, only critical errors and serious warnings will be logged\&. Level 1 is a reasonable level for day\-to\-day running \- it generates a small amount of information about operations carried out\&.
59.sp
60Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem\&. Levels above 3 are designed for use only by developers and generate HUGE amounts of log data, most of which is extremely cryptic\&.
61.sp
62Note that specifying this parameter here will override the
63\m[blue]\fB\%smb.conf.5.html#\fR\m[]
64parameter in the
65smb\&.conf
66file\&.
67.RE
68.PP
69\-V|\-\-version
70.RS 4
71Prints the program version number\&.
72.RE
73.PP
74\-s|\-\-configfile <configuration file>
75.RS 4
76The file specified contains the configuration details required by the server\&. The information in this file includes server\-specific information such as what printcap file to use, as well as descriptions of all the services that the server is to provide\&. See
77smb\&.conf
78for more information\&. The default configuration file name is determined at compile time\&.
79.RE
80.PP
81\-l|\-\-log\-basename=logdirectory
82.RS 4
83Base directory name for log/debug files\&. The extension
84\fB"\&.progname"\fR
85will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&.
86.RE
87.SH "COMMANDS"
88.PP
89\fIVFS COMMANDS\fR
90.sp
91.RS 4
92.ie n \{\
93\h'-04'\(bu\h'+03'\c
94.\}
95.el \{\
96.sp -1
97.IP \(bu 2.3
98.\}
99load <module\&.so>
100\- Load specified VFS module
101.RE
102.sp
103.RS 4
104.ie n \{\
105\h'-04'\(bu\h'+03'\c
106.\}
107.el \{\
108.sp -1
109.IP \(bu 2.3
110.\}
111populate <char> <size>
112\- Populate a data buffer with the specified data
113.RE
114.sp
115.RS 4
116.ie n \{\
117\h'-04'\(bu\h'+03'\c
118.\}
119.el \{\
120.sp -1
121.IP \(bu 2.3
122.\}
123showdata [<offset> <len>]
124\- Show data currently in data buffer
125.RE
126.sp
127.RS 4
128.ie n \{\
129\h'-04'\(bu\h'+03'\c
130.\}
131.el \{\
132.sp -1
133.IP \(bu 2.3
134.\}
135connect
136\- VFS connect()
137.RE
138.sp
139.RS 4
140.ie n \{\
141\h'-04'\(bu\h'+03'\c
142.\}
143.el \{\
144.sp -1
145.IP \(bu 2.3
146.\}
147disconnect
148\- VFS disconnect()
149.RE
150.sp
151.RS 4
152.ie n \{\
153\h'-04'\(bu\h'+03'\c
154.\}
155.el \{\
156.sp -1
157.IP \(bu 2.3
158.\}
159disk_free
160\- VFS disk_free()
161.RE
162.sp
163.RS 4
164.ie n \{\
165\h'-04'\(bu\h'+03'\c
166.\}
167.el \{\
168.sp -1
169.IP \(bu 2.3
170.\}
171opendir
172\- VFS opendir()
173.RE
174.sp
175.RS 4
176.ie n \{\
177\h'-04'\(bu\h'+03'\c
178.\}
179.el \{\
180.sp -1
181.IP \(bu 2.3
182.\}
183readdir
184\- VFS readdir()
185.RE
186.sp
187.RS 4
188.ie n \{\
189\h'-04'\(bu\h'+03'\c
190.\}
191.el \{\
192.sp -1
193.IP \(bu 2.3
194.\}
195mkdir
196\- VFS mkdir()
197.RE
198.sp
199.RS 4
200.ie n \{\
201\h'-04'\(bu\h'+03'\c
202.\}
203.el \{\
204.sp -1
205.IP \(bu 2.3
206.\}
207rmdir
208\- VFS rmdir()
209.RE
210.sp
211.RS 4
212.ie n \{\
213\h'-04'\(bu\h'+03'\c
214.\}
215.el \{\
216.sp -1
217.IP \(bu 2.3
218.\}
219closedir
220\- VFS closedir()
221.RE
222.sp
223.RS 4
224.ie n \{\
225\h'-04'\(bu\h'+03'\c
226.\}
227.el \{\
228.sp -1
229.IP \(bu 2.3
230.\}
231open
232\- VFS open()
233.RE
234.sp
235.RS 4
236.ie n \{\
237\h'-04'\(bu\h'+03'\c
238.\}
239.el \{\
240.sp -1
241.IP \(bu 2.3
242.\}
243close
244\- VFS close()
245.RE
246.sp
247.RS 4
248.ie n \{\
249\h'-04'\(bu\h'+03'\c
250.\}
251.el \{\
252.sp -1
253.IP \(bu 2.3
254.\}
255read
256\- VFS read()
257.RE
258.sp
259.RS 4
260.ie n \{\
261\h'-04'\(bu\h'+03'\c
262.\}
263.el \{\
264.sp -1
265.IP \(bu 2.3
266.\}
267write
268\- VFS write()
269.RE
270.sp
271.RS 4
272.ie n \{\
273\h'-04'\(bu\h'+03'\c
274.\}
275.el \{\
276.sp -1
277.IP \(bu 2.3