grab.1 2.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. .TH grab 1 "Mar 2014" "plc-utils-2.1.6" "Qualcomm Atheros Powerline Toolkit"
  2. .SH NAME
  3. grab - byte grabber
  4. .SH SYNOPSIS
  5. .BR grab
  6. .RI [ options ]
  7. .IR file
  8. .RI [ file ]
  9. .RI [ ... ]
  10. .PP
  11. .BR grab
  12. .RI [ options ]
  13. .RI [< stdin ]
  14. .RI [> stdout ]
  15. .SH DESCRIPTION
  16. Extract a range of bytes from a file and print them as an undelimited hexadecimal character string.
  17. .SH OPTIONS
  18. .TP
  19. -\fBl\fR \fIlength\fR
  20. The number of consective bytes to read.
  21. The \fIlength\fR may be expressed in decimal, hexadecimal or binary.
  22. Decimal is the default.
  23. Hexadecimal values start with \fB0x\fR.
  24. Binary values start with \fB0b\fR.
  25. If \fBoffset\fR plus \fIlength\fR exceeds the file size then an error will occur.
  26. .TP
  27. .RB - n
  28. Append a newline to each line of program output.
  29. The newline is suppressed by default.
  30. .TP
  31. -\fBo\fR \fIoffset\fR
  32. The \fBfile\fR offset of the first byte read.
  33. The offset may be expressed in hexadecimal or binary.
  34. Hexadecimal is the default.
  35. Binary values start with \fB0b\fR.
  36. If \fBoffset\fR plus \fIlength\fR exceeds the file size then an error will occur.
  37. .TP
  38. .BR -q
  39. Enable quiet mode which has no effect.
  40. .TP
  41. .RB - s
  42. Display the output as a text string instead of a hexadecimal character stream.
  43. If the selected data contains control characters then output may be unreadable or cause unwanted console behavior.
  44. .TP
  45. .RB - v
  46. Append the input filename to each line of program output.
  47. .TP
  48. .RB - ? ,-- help
  49. Print program help summary on stdout.
  50. This option takes precedence over other options on the command line.
  51. .TP
  52. .RB - ! ,-- version
  53. Print program version information on stdout.
  54. This option takes precedence over other options on the command line.
  55. Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of the Linux Toolkit you are using.
  56. .SH ARGUMENTS
  57. .TP
  58. .IR file
  59. A filename.
  60. No assumptions are made based on filename and no filename conventions are enforced.
  61. More than one filename may appear on the command line.
  62. If no filename appears then input is read from stdin.
  63. .SH EXAMPLES
  64. None.
  65. .SH SEE ALSO
  66. .BR pad ( 1 )
  67. .SH CREDITS
  68. Charles Maier <cmaier@qca.qualcomm.com>