1VFSTEST(1)                       User Commands                      VFSTEST(1)
2
3
4

NAME

6       vfstest - tool for testing samba VFS modules
7

SYNOPSIS

9       vfstest [-d debuglevel] [-c command] [-l logdir] [-h]
10

DESCRIPTION

12       This tool is part of the samba(7) suite.
13
14       vfstest is a small command line utility that has the ability to test
15       dso samba VFS modules. It gives the user the ability to call the
16       various VFS functions manually and supports cascaded VFS modules.
17

OPTIONS

19       -c|--command=command
20           Execute the specified (semicolon-separated) commands. See below for
21           the commands that are available.
22
23       -?|--help
24           Print a summary of command line options.
25
26       -l|--logfile=logbasename
27           File name for log/debug files. The extension '.client' will be
28           appended. The log file is never removed by the client.
29
30       -d|--debuglevel=level
31           level is an integer from 0 to 10. The default value if this
32           parameter is not specified is 0.
33
34           The higher this value, the more detail will be logged to the log
35           files about the activities of the server. At level 0, only critical
36           errors and serious warnings will be logged. Level 1 is a reasonable
37           level for day-to-day running - it generates a small amount of
38           information about operations carried out.
39
40           Levels above 1 will generate considerable amounts of log data, and
41           should only be used when investigating a problem. Levels above 3
42           are designed for use only by developers and generate HUGE amounts
43           of log data, most of which is extremely cryptic.
44
45           Note that specifying this parameter here will override the log
46           level parameter in the smb.conf file.
47
48       -V|--version
49           Prints the program version number.
50
51       -s|--configfile=<configuration file>
52           The file specified contains the configuration details required by
53           the server. The information in this file includes server-specific
54           information such as what printcap file to use, as well as
55           descriptions of all the services that the server is to provide. See
56           smb.conf for more information. The default configuration file name
57           is determined at compile time.
58
59       -l|--log-basename=logdirectory
60           Base directory name for log/debug files. The extension ".progname"
61           will be appended (e.g. log.smbclient, log.smbd, etc...). The log
62           file is never removed by the client.
63
64       --option=<name>=<value>
65           Set the smb.conf(5) option "<name>" to value "<value>" from the
66           command line. This overrides compiled-in defaults and options read
67           from the configuration file.
68

COMMANDS

70       VFS COMMANDS
71
72              •   load <module.so> - Load specified VFS module
73
74              •   populate <char> <size> - Populate a data buffer with the
75                  specified data
76
77              •   showdata [<offset> <len>] - Show data currently in data
78                  buffer
79
80              •   connect - VFS connect()
81
82              •   disconnect - VFS disconnect()
83
84              •   disk_free - VFS disk_free()
85
86              •   opendir - VFS opendir()
87
88              •   readdir - VFS readdir()
89
90              •   mkdir - VFS mkdir()
91
92              •   rmdir - VFS rmdir()
93
94              •   closedir - VFS closedir()
95
96              •   open - VFS open()
97
98              •   close - VFS close()
99
100              •   read - VFS read()
101
102              •   write - VFS write()
103
104              •   lseek - VFS lseek()
105
106              •   rename - VFS rename()
107
108              •   fsync - VFS fsync()
109
110              •   stat - VFS stat()
111
112              •   fstat - VFS fstat()
113
114              •   lstat - VFS lstat()
115
116              •   unlink - VFS unlink()
117
118              •   chmod - VFS chmod()
119
120              •   fchmod - VFS fchmod()
121
122              •   chown - VFS chown()
123
124              •   fchown - VFS fchown()
125
126              •   chdir - VFS chdir()
127
128              •   getwd - VFS getwd()
129
130              •   utime - VFS utime()
131
132              •   ftruncate - VFS ftruncate()
133
134              •   lock - VFS lock()
135
136              •   symlink - VFS symlink()
137
138              •   readlink - VFS readlink()
139
140              •   link - VFS link()
141
142              •   mknod - VFS mknod()
143
144              •   realpath - VFS realpath()
145
146              •   getxattr - VFS getxattr()
147
148              •   listxattr - VFS listxattr()
149
150              •   setxattr - VFS setxattr()
151
152              •   removexattr - VFS removexattr()
153
154              •   fget_nt_acl - VFS fget_nt_acl()
155
156              •   get_nt_acl - VFS get_nt_acl()
157
158              •   fset_nt_acl - VFS fset_nt_acl()
159
160              •   set_nt_acl - VFS open() and fset_nt_acl()
161
162              •   sys_acl_get_file - VFS sys_acl_get_file()
163
164              •   sys_acl_get_fd - VFS sys_acl_get_fd()
165
166              •   sys_acl_blob_get_file - VFS sys_acl_blob_get_file()
167
168              •   sys_acl_blob_get_fd - VFS sys_acl_blob_get_fd()
169
170              •   sys_acl_delete_def_file - VFS sys_acl_delete_def_file()
171
172              •   test_chain - test chain code
173
174              •   translate_name - VFS translate_name()
175
176
177       GENERAL COMMANDS
178
179              •   conf <smb.conf> - Load a different configuration file
180
181              •   help [<command>] - Get list of commands or info about
182                  specified command
183
184              •   debuglevel <level> - Set debug level
185
186              •   freemem - Free memory currently in use
187
188              •   exit - Exit vfstest
189

VERSION

191       This man page is part of version 4.14.5 of the Samba suite.
192

AUTHOR

194       The original Samba software and related utilities were created by
195       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
196       Source project similar to the way the Linux kernel is developed.
197
198       The vfstest man page was written by Jelmer Vernooij. Updated version by
199       Guenter Kukkukk.
200
201
202
203Samba 4.14.5                      06/01/2021                        VFSTEST(1)