xref: /dragonfly/usr.bin/file2c/file2c.1 (revision 984263bc)
1.\"----------------------------------------------------------------------------
2.\" "THE BEER-WARE LICENSE" (Revision 42):
3.\" <phk@FreeBSD.org> wrote this file.  As long as you retain this notice, you
4.\" can do whatever you want with this file. If we meet some day, and you think
5.\" this stuff is worth it, you can buy me a beer in return.  Poul-Henning Kamp
6.\" ---------------------------------------------------------------------------
7.\"
8.\" $FreeBSD: src/usr.bin/file2c/file2c.1,v 1.6.2.4 2001/08/16 13:16:48 ru Exp $
9.\"
10.Dd January 28, 1995
11.Dt FILE2C 1
12.Os
13.Sh NAME
14.Nm file2c
15.Nd convert file to c-source
16.Sh SYNOPSIS
17.Nm
18.Op "string"
19.Op "string"
20.Sh DESCRIPTION
21The
22.Nm
23utility reads a file from stdin and writes it to stdout, converting each
24byte to its decimal representation on the fly.
25.Pp
26If the first
27.Op string
28is present, it is printed before the data; if the second
29.Op string
30is present, it is printed after the data.
31.Pp
32This program is used to embed binary or other files into C source files,
33for instance as a char[].
34.Sh EXAMPLES
35The command:
36.Bd -literal -offset indent
37date | file2c 'const char date[] = {' ',0};'
38.Ed
39.Pp
40will produce:
41.Bd -literal -offset indent
42const char date[] = {
4383,97,116,32,74,97,110,32,50,56,32,49,54,58,50,56,58,48,53,
4432,80,83,84,32,49,57,57,53,10
45,0};
46.Ed
47