xref: /freebsd/usr.bin/file2c/file2c.1 (revision 17ee9d00bc1ae1e598c38f25826f861e4bc6c3ce)
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.\" $Id$
9.\"
10.Dd Jan 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 file2c
18.Op "string"
19.Op "string"
20.Sh DESCRIPTION
21The
22.Nm file2c
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 embedd binary or other files into C source files,
33for instance as a char[].
34.Sh EXAMPLE
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
48
49