webcomp.1 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. .TH MAKEROM "1" "March 2014" "makerom" "User Commands"
  2. .SH NAME
  3. webcomp - Compile files into C source code
  4. .SH SYNOPSIS
  5. .B webcomp [options] files ... >output.c
  6. .P
  7. [\fI--files fileList\fR]
  8. [\fI--name structName\fR]
  9. [\fI--strip prefix\fR]
  10. .SH DESCRIPTION
  11. To enable files to be accessed on embedded systems without a file system, the
  12. \fBwebcomp\fR command converts arbitrary files into C code that
  13. can be compiled and linked into a program. This is useful for applications
  14. that must execute completely from ROM and not access a file system.
  15. This facility can also enhance security by preventing the
  16. modification of files.
  17. .PP
  18. The MPR portable runtime provides routines which can then read these files
  19. much as you would read any file on disk.
  20. .SH OPTIONS
  21. .TP
  22. \fB\--files fileList\fR
  23. Option to provide a list of files that should be converted.
  24. \fB\--p strip\fR
  25. Specifies a prefix to remove from each of the compiled file names.
  26. .TP
  27. \fB\--name structName\fR
  28. Specifies the name of top level C structure that holds the converted files.
  29. .PP
  30. .SH "EXAMPLE"
  31. This example will create a list of web files and then convert these
  32. files into C structures in the file romFiles.c.
  33. .PP
  34. find web -type f -print >fileList
  35. .PP
  36. webcomp --files filelist >romFiles.c
  37. .PP
  38. cc -o romFiles.o romFiles.c
  39. .SH "REPORTING BUGS"
  40. Report bugs to <dev@embedthis.com>.
  41. .SH COPYRIGHT
  42. Copyright \(co Embedthis Software.
  43. .br
  44. .SH "SEE ALSO"