usr.bin/file2c/file2c.1

   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$
   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
  21 The
  22 .Nm
  23 utility reads a file from stdin and writes it to stdout, converting each
  24 byte to its decimal representation on the fly.
  25 .Pp
  26 If the first
  27 .Op string
  28 is present, it is printed before the data; if the second
  29 .Op string
  30 is present, it is printed after the data.
  31 .Pp
  32 This program is used to embed binary or other files into C source files,
  33 for instance as a char[].
  34 .Sh EXAMPLES
  35 The command:
  36 .Bd -literal -offset indent
  37 date | file2c 'const char date[] = {' ',0};'
  38 .Ed
  39 .Pp
  40 will produce:
  41 .Bd -literal -offset indent
  42 const char date[] = {
  43 83,97,116,32,74,97,110,32,50,56,32,49,54,58,50,56,58,48,53,
  44 32,80,83,84,32,49,57,57,53,10
  45 ,0};
  46 .Ed