xref: /freebsd/usr.bin/file2c/file2c.1 (revision 380a989b3223d455375b4fae70fd0b9bdd43bafb)
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: file2c.1,v 1.4 1997/06/23 04:51:58 steve 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 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