summaryrefslogtreecommitdiffstats
path: root/docs-xml/manpages/vfs_cap.8.xml
blob: 46dd90070d477ccfdc0a53426031f1e7cbd9c7ec (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
<?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="vfs_cap.8">

<refmeta>
	<refentrytitle>vfs_cap</refentrytitle>
	<manvolnum>8</manvolnum>
	<refmiscinfo class="source">Samba</refmiscinfo>
	<refmiscinfo class="manual">System Administration tools</refmiscinfo>
	<refmiscinfo class="version">&doc.version;</refmiscinfo>
</refmeta>


<refnamediv>
	<refname>vfs_cap</refname>
	<refpurpose>CAP encode filenames</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
		<command>vfs objects = cap</command>
	</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>

	<para>This VFS module is part of the
	<citerefentry><refentrytitle>samba</refentrytitle>
	<manvolnum>7</manvolnum></citerefentry> suite.</para>

	<para>CAP (Columbia Appletalk Protocol) encoding is a
	technique for representing non-ASCII filenames in ASCII. The
	<command>vfs_cap</command> VFS module translates filenames to and
	from CAP format, allowing users to name files in their native
	encoding.  </para>

	<para>CAP encoding is most commonly
	used in Japanese language environments. </para>

	<para>This module is stackable.</para>

</refsect1>


<refsect1>
	<title>EXAMPLES</title>

	<para>On a system using GNU libiconv, use CAP encoding to support
	users in the Shift_JIS locale:</para>

<programlisting>
        <smbconfsection name="[global]"/>
	<smbconfoption name="dos charset">CP932</smbconfoption>
	<smbconfoption name="dos charset">CP932</smbconfoption>
	<smbconfoption name="vfs objects">cap</smbconfoption>
</programlisting>

</refsect1>

<refsect1>
	<title>VERSION</title>

	<para>This man page is part of version &doc.version; of the Samba suite.
	</para>
</refsect1>

<refsect1>
	<title>AUTHOR</title>

	<para>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.</para>

</refsect1>

</refentry>