1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
10 .de Sp \" Vertical space (when we can't use .PP)
16 .ie \\n(.$>=3 .ne \\$3
20 .TH "VFSTEST" 1 "" "" ""
22 vfstest \- tool for testing samba VFS modules
27 \fBvfstest\fR [\-d\ debuglevel] [\-c\ command] [\-l\ logdir] [\-h]
34 This tool is part of the \fBsamba\fR(7) suite\&.
37 \fBvfstest\fR is 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\&.
42 \-c|\-\-command=command
43 Execute the specified (colon\-separated) commands\&. See below for the commands that are available\&.
47 Print a summary of command line options\&.
50 \-l|\-\-logfile=logbasename
51 File name for log/debug files\&. The extension\fB'\&.client'\fR will be appended\&. The log file is never removed by the client\&.
55 Prints the program version number\&.
58 \-s <configuration file>
59 The 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 \fIsmb\&.conf\fR for more information\&. The default configuration file name is determined at compile time\&.
62 \-d|\-\-debuglevel=level
63 \fIlevel\fR is an integer from 0 to 10\&. The default value if this parameter is not specified is zero\&.
65 The 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\&.
67 Levels 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\&.
69 Note that specifying this parameter here will override the parameter in the \fIsmb\&.conf\fR file\&.
72 \-l|\-\-logfile=logdirectory
73 Base directory name for log/debug files\&. The extension \fB"\&.progname"\fR will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&.
82 \fBload <module\&.so>\fR \- Load specified VFS module
85 \fBpopulate <char> <size>\fR \- Populate a data buffer with the specified data
88 \fBshowdata [<offset> <len>]\fR \- Show data currently in data buffer
91 \fBconnect\fR \- VFS connect()
94 \fBdisconnect\fR \- VFS disconnect()
97 \fBdisk_free\fR \- VFS disk_free()
100 \fBopendir\fR \- VFS opendir()
103 \fBreaddir\fR \- VFS readdir()
106 \fBmkdir\fR \- VFS mkdir()
109 \fBrmdir\fR \- VFS rmdir()
112 \fBclosedir\fR \- VFS closedir()
115 \fBopen\fR \- VFS open()
118 \fBclose\fR \- VFS close()
121 \fBread\fR \- VFS read()
124 \fBwrite\fR \- VFS write()
127 \fBlseek\fR \- VFS lseek()
130 \fBrename\fR \- VFS rename()
133 \fBfsync\fR \- VFS fsync()
136 \fBstat\fR \- VFS stat()
139 \fBfstat\fR \- VFS fstat()
142 \fBlstat\fR \- VFS lstat()
145 \fBunlink\fR \- VFS unlink()
148 \fBchmod\fR \- VFS chmod()
151 \fBfchmod\fR \- VFS fchmod()
154 \fBchown\fR \- VFS chown()
157 \fBfchown\fR \- VFS fchown()
160 \fBchdir\fR \- VFS chdir()
163 \fBgetwd\fR \- VFS getwd()
166 \fButime\fR \- VFS utime()
169 \fBftruncate\fR \- VFS ftruncate()
172 \fBlock\fR \- VFS lock()
175 \fBsymlink\fR \- VFS symlink()
178 \fBreadlink\fR \- VFS readlink()
181 \fBlink\fR \- VFS link()
184 \fBmknod\fR \- VFS mknod()
187 \fBrealpath\fR \- VFS realpath()
191 \fBGENERAL COMMANDS\fR
195 \fBconf <smb\&.conf>\fR \- Load a different configuration file
198 \fBhelp [<command>]\fR \- Get list of commands or info about specified command
201 \fBdebuglevel <level>\fR \- Set debug level
204 \fBfreemem\fR \- Free memory currently in use
207 \fBexit\fR \- Exit vfstest
213 This man page is correct for version 3\&.0 of the Samba suite\&.
218 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\&.
221 The vfstest man page was written by Jelmer Vernooij\&.