xref: /dflybsd-src/usr.bin/mkcsmapper/mkcsmapper.1 (revision ed768960729b416f420895efe2d1cd63d70aeb60)
1094529c7SSascha Wildner.\" Copyright (c) 2009 Gabor Kovesdan <gabor@FreeBSD.org>
2094529c7SSascha Wildner.\" All rights reserved.
3094529c7SSascha Wildner.\"
4094529c7SSascha Wildner.\" Redistribution and use in source and binary forms, with or without
5094529c7SSascha Wildner.\" modification, are permitted provided that the following conditions
6094529c7SSascha Wildner.\" are met:
7094529c7SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
8094529c7SSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
9094529c7SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
10094529c7SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
11094529c7SSascha Wildner.\"    documentation and/or other materials provided with the distribution.
12094529c7SSascha Wildner.\"
13094529c7SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14094529c7SSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15094529c7SSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16094529c7SSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17094529c7SSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18094529c7SSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19094529c7SSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20094529c7SSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21094529c7SSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22094529c7SSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23094529c7SSascha Wildner.\" SUCH DAMAGE.
24094529c7SSascha Wildner.\"
25094529c7SSascha Wildner.\" Portions of this text are reprinted and reproduced in electronic form
26094529c7SSascha Wildner.\" from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology --
27094529c7SSascha Wildner.\" Portable Operating System Interface (POSIX), The Open Group Base
28094529c7SSascha Wildner.\" Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of
29094529c7SSascha Wildner.\" Electrical and Electronics Engineers, Inc and The Open Group.  In the
30094529c7SSascha Wildner.\" event of any discrepancy between this version and the original IEEE and
31094529c7SSascha Wildner.\" The Open Group Standard, the original IEEE and The Open Group Standard is
32094529c7SSascha Wildner.\" the referee document.  The original Standard can be obtained online at
33094529c7SSascha Wildner.\"     http://www.opengroup.org/unix/online.html.
34094529c7SSascha Wildner.\"
350d5acd74SJohn Marino.\" $FreeBSD: head/usr.bin/mkcsmapper/mkcsmapper.1 222286 2011-05-25 14:13:53Z ru $
36094529c7SSascha Wildner.\"
37094529c7SSascha Wildner.Dd June 2, 2011
38094529c7SSascha Wildner.Dt MKCSMAPPER 1
39094529c7SSascha Wildner.Os
40094529c7SSascha Wildner.Sh NAME
41094529c7SSascha Wildner.Nm mkcsmapper
42094529c7SSascha Wildner.Nd generates hashed conversion data for
43094529c7SSascha Wildner.Xr iconv 3
44094529c7SSascha Wildner.Sh SYNOPSIS
45094529c7SSascha Wildner.Nm
46094529c7SSascha Wildner.Op Fl mpd
47094529c7SSascha Wildner.Fl o
48094529c7SSascha Wildner.Ar outfile
49094529c7SSascha Wildner.Ar infile
50094529c7SSascha Wildner.Sh DESCRIPTION
51094529c7SSascha WildnerThe
52094529c7SSascha Wildner.Nm
53094529c7SSascha Wildnerutility generates binary conversion data from plain text conversion tables
54094529c7SSascha Wildnerfor the
55094529c7SSascha Wildner.Xr iconv 3
56094529c7SSascha Wildnerlibrary.
57094529c7SSascha WildnerThe conversion data has two components:
58094529c7SSascha WildnerThe conversion mapping between specific character encodings.
59094529c7SSascha WildnerA pivot file, which the possible source and destination encoding
60094529c7SSascha Wildnerpairs or the set of mappings to use for a compound encoding.
61094529c7SSascha Wildner.Pp
62094529c7SSascha WildnerThe following options are available:
63094529c7SSascha Wildner.Bl -tag -width 0123
64094529c7SSascha Wildner.It Fl d
65094529c7SSascha WildnerTurns on debug mode.
66094529c7SSascha Wildner.It Fl m
67094529c7SSascha WildnerGenerate mapping data from
68094529c7SSascha Wildner.Ar infile .
69094529c7SSascha Wildner.It Fl o Ar outfile
70094529c7SSascha WildnerPut generated binary data to
71094529c7SSascha Wildner.Ar outfile .
72094529c7SSascha Wildner.It Fl p
73094529c7SSascha WildnerGenerate pivot data from
74094529c7SSascha Wildner.Ar outfile .
75094529c7SSascha Wildner.El
76094529c7SSascha Wildner.Sh EXIT STATUS
77094529c7SSascha Wildner.Ex -std mkcsmapper
78094529c7SSascha Wildner.Sh SEE ALSO
79094529c7SSascha Wildner.Xr iconv 1 ,
80*ed768960SSascha Wildner.Xr mkesdb 1 ,
81*ed768960SSascha Wildner.Xr iconv 3
82094529c7SSascha Wildner.Sh HISTORY
83094529c7SSascha Wildner.Nm
84094529c7SSascha Wildnerfirst appeared in
850d5acd74SJohn Marino.Nx 2.0 , and made its appearance in
86094529c7SSascha Wildner.Dx 1.1 .
87094529c7SSascha Wildner.Sh AUTHORS
88094529c7SSascha WildnerThis manual page was written by
899e570176SFranco Fichtner.An Gabor Kovesdan Aq Mt gabor@FreeBSD.org .
90