0467614a12
Approved by: re (kensmith) The merged revisions/files are: Revision Path 1.10 src/lib/libarchive/archive_entry.3 1.21 src/lib/libarchive/archive_read.3 1.8 src/lib/libautofs/libautofs.3 1.10 src/lib/libc/net/inet6_rth_space.3 1.8 src/lib/libc/posix1e/acl_get_entry.3 1.15 src/lib/libc/posix1e/mac.3 1.7 src/lib/libc/posix1e/mac_prepare.3 1.37 src/lib/libc/stdtime/strftime.3 1.16 src/lib/libc/sys/kse.2 1.8 src/lib/libc/sys/uuidgen.2 1.4 src/share/man/man4/man4.i386/acpi_ibm.4 1.6 src/share/man/man4/man4.i386/acpi_panasonic.4 1.40 src/share/man/man4/man4.i386/ep.4 1.6 src/share/man/man4/man4.i386/pbio.4 1.5 src/share/man/man4/man4.i386/snc.4 1.2 src/share/man/man4/man4.sparc64/openprom.4 1.4 src/share/man/man4/man4.sparc64/snd_audiocs.4 1.11 src/share/man/man4/witness.4 1.3 src/share/man/man5/devfs.conf.5 1.51 src/share/man/man9/ifnet.9 1.7 src/share/man/man9/printf.9 1.12 src/usr.bin/file2c/file2c.1 1.27 src/usr.bin/indent/indent.1 1.17 src/usr.bin/lockf/lockf.1 1.90 src/usr.bin/make/make.1 1.45 src/usr.bin/systat/systat.1 1.19 src/usr.bin/truss/truss.1 1.33 src/usr.bin/xinstall/install.1 1.11 src/usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 1.4 src/usr.sbin/bluetooth/sdpd/sdpd.8 1.9 src/usr.sbin/bsnmpd/modules/snmp_netgraph/snmp_netgraph.3 1.36 src/usr.sbin/i4b/isdnd/isdnd.rc.5 1.53 src/usr.sbin/mtree/mtree.8 1.8 src/usr.sbin/ndiscvt/ndiscvt.8 1.13 src/usr.sbin/ntp/doc/ntpdc.8 1.26 src/usr.sbin/pppd/pppd.8 1.40 src/usr.sbin/syslogd/syslog.conf.5 1.5 src/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5
72 lines
2.2 KiB
Groff
72 lines
2.2 KiB
Groff
.\"----------------------------------------------------------------------------
|
|
.\" "THE BEER-WARE LICENSE" (Revision 42):
|
|
.\" <phk@FreeBSD.org> wrote this file. As long as you retain this notice, you
|
|
.\" can do whatever you want with this file. If we meet some day, and you think
|
|
.\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
|
|
.\" ---------------------------------------------------------------------------
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd May 14, 2005
|
|
.Dt FILE2C 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm file2c
|
|
.Nd convert file to c-source
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl n Ar count
|
|
.Op Fl x
|
|
.Op Ar prefix Op Ar suffix
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility reads a file from stdin and writes it to stdout, converting each
|
|
byte to its decimal or hexadecimal representation on the fly.
|
|
The byte values are separated by a comma.
|
|
This also means that the last byte value is not followed by a comma.
|
|
By default the byte values are printed in decimal, but when the
|
|
.Fl x
|
|
option is given, the values will be printed in hexadecimal.
|
|
.Pp
|
|
If more than 70 characters are printed on the same line, that line is
|
|
ended and the output continues on the next line.
|
|
With the
|
|
.Fl n
|
|
option this can be made to happen after the specified number of
|
|
byte values have been printed.
|
|
The length of the line will not be considered anymore.
|
|
To have all the byte values printed on the same line, give the
|
|
.Fl n
|
|
option a negative number.
|
|
.Pp
|
|
A prefix and suffix strings can be printed before and after the byte values
|
|
(resp.)
|
|
If a suffix is to be printed, a prefix must also be specified.
|
|
The first non-option word is the prefix, which may optionally be followed
|
|
by a word that is to be used as the suffix.
|
|
.Pp
|
|
This program is typically used to embed binary files into C source files.
|
|
The prefix is used to define an array type and the suffix is used to end
|
|
the C statement.
|
|
The
|
|
.Fl x
|
|
and
|
|
.Fl n
|
|
options are useful when the binary data represents a bitmap and the output
|
|
needs to remain readable and/or editable.
|
|
Fonts, for example, are a good example of this.
|
|
.Sh EXAMPLES
|
|
The command:
|
|
.Bd -literal -offset indent
|
|
date | file2c 'const char date[] = {' ',0};'
|
|
.Ed
|
|
.Pp
|
|
will produce:
|
|
.Bd -literal -offset indent
|
|
const char date[] = {
|
|
83,97,116,32,74,97,110,32,50,56,32,49,54,58,50,56,58,48,53,
|
|
32,80,83,84,32,49,57,57,53,10
|
|
,0};
|
|
.Ed
|