summaryrefslogtreecommitdiff
path: root/source4/torture/man/masktest.1.xml
blob: 170450bc087a6860b94830d7dacf3cf6dfc0b2e7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<refentry id="masktest.1">

<refmeta>
	<refentrytitle>masktest</refentrytitle>
	<manvolnum>1</manvolnum>
</refmeta>


<refnamediv>
	<refname>masktest</refname>
	<refpurpose>Find differences in wildcard matching between 
	Samba's implementation and that of a remote server.</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
		<command>masktest</command>
		<arg choice="req">//server/share</arg>
		<arg choice="opt">-U user%pass</arg>
		<arg choice="opt">-d debuglevel</arg>
		<arg choice="opt">-W workgroup</arg>
		<arg choice="opt">-n numloops</arg>
		<arg choice="opt">-s seed</arg>
		<arg choice="opt">-a</arg>
		<arg choice="opt">-E</arg>
		<arg choice="opt">-M max protocol</arg>
		<arg choice="opt">-f filechars</arg>
		<arg choice="opt">-m maskchars</arg>
		<arg choice="opt">-v</arg>
	</cmdsynopsis>
	
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>

	<para><application>masktest</application> is a utility for 
		detecting differences in behaviour between Samba's 
		own implementation and that of a remote server.
		It will run generate random filenames/masks and 
		check if these match the same files they do on the remote file as 
		they do on the local server. It will display any differences it finds.
	</para>

	<para>
		This utility is used by the Samba team to find differences in 
		behaviour between Samba and Windows servers. 
	</para>
</refsect1>


<refsect1>
	<title>OPTIONS</title>

	<variablelist>
		<varlistentry>
			<term>-U user%pass</term>
			<listitem><para>
					Specify the user and password to use when logging on 
					on the shares. This parameter can be specified twice 
					(once for the first server, once for the second).
			</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-s seed</term>
			<listitem><para>
					Seed the random number generator with the specified value.
			</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-n numops</term>
			<listitem><para>Set the number of operations to perform.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-a</term>
			<listitem><para>Print the operations that are performed. </para></listitem>
		</varlistentry>
		
		<varlistentry>
			<term>-M max_protocol</term>
			<listitem><para>
					Maximum protocol to use.
			</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-f</term>
			<listitem><para>Specify characters that can be used 
					when generating file names. Default: abcdefghijklm.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-E</term>
			<listitem><para>Abort when difference in behaviour is found.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-m maskchars</term>
			<listitem><para>Specify characters used for wildcards.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-v</term>
			<listitem><para>Be verbose</para></listitem>
		</varlistentry>

	</variablelist>
</refsect1>

<refsect1>
	<title>VERSION</title>

	<para>This man page is correct for version 4.0 of the Samba suite.</para>
</refsect1>

<refsect1>
	<title>SEE ALSO</title>

	<para>Samba</para>

</refsect1>

<refsect1>
	<title>AUTHOR</title>

	<para>This utility is part of the <ulink url="http://www.samba.org/">Samba</ulink> suite, which is developed by the global <ulink url="http://www.samba.org/samba/team/">Samba Team</ulink>.</para>

	<para>masktest was written by Andrew Tridgell.</para>

	<para>This manpage was written by Jelmer Vernooij.</para>
	
</refsect1>

</refentry>