binary2ascii(1) 					      General Commands Manual						   binary2ascii(1)

NAME

       binary2ascii - Convert binary numbers to textual representation

SYNOPSIS

       binary2ascii [flags]

DESCRIPTION

       binary2ascii  reads  input  consisting of binary numbers and converts them to their textual representation.  Command line flags specify the
       type and size of the binary numbers and provide control over the format of the output. Unsigned integers may  be  written  out  in  binary,
       octal,  decimal,  or  hexadecimal. Signed integers may be written out only in binary or decimal.  Floating point numbers may be written out
       only in decimal, either in standard or scientific notation. (If you want to examine the binary representation of  floating  point  numbers,
       just treat the input as a sequence of unsigned characters.)

COMMAND LINE FLAGS

       Long options may not be available on some systems.

       -b,--base <base>
	      Base for integer conversions: b(binary),d(ecimal), h(exadecimal), o(ctal), or 2,8,10, or 16.

       -d,--delimit
	      Delimit  the  output  as per the locale. This is the default on systems in which printf(3) supports delimitation. If delimitation is
	      not enabled, floating point numbers will have a decimal point and no separation of groups, integers no delimiters at all. With  this
	      option,  the  decimal separator will be chosen according to the locale (which, for example, may make it a comma), and non-fractional
	      digits will be grouped and separated according to the rules for the locale in force. For American  English,  this  means	groups	of
	      three digits separated by commas, whereas for German in Germany it means groups of three digits separated by periods.

       -D,--do-not-delimit
	      Do not delimit the output as per the -d option.

       -e,--exponential
	      Use exponential (scientific) notation.

       -h,--help
	      print help message

       -l,--linefeed
	      add a linefeed after every 0x0A value if the size is char, short, int, or long, that is, the sizes that might represent a character.

       -L,locale <locale>
	      Set the LC_NUMERIC facet of the locale to <locale>.

       -n,--number <number>
	      number of items to print per line.

       -o,--offset <offset>
	      byte offset at which to start.

       -p,--precision <precision>
	      the precision to use when printing floating point numbers.

       -s,--sizes
	      print sizes of types on current machine and related information

       -t,--type <type>
	      set type and size of input

       -x,--no-hex-mark
	      do not mark hexadecimal output with the prefix 0x.

       -V,--verbose
	      be verbose.

       -v,--version
	      print version information.

       -w,--width
	      minimum field width.

       -X,--explain-exit-codes
	      print a summary of the exit status codes.

       -z,--zero-pad-integers
	      zero pad on left.

       -Z,--do-not-zero-pad-integers
	      do not zero pad on left

INPUT TYPES

       The following are the possible input types. Note that some types may not be available on some machines.

       d  double

       f  float

       q long double

       sc signed char

       ss signed short

       si signed int

       sl signed long

       sq signed long long

       uc unsigned char

       us unsigned short

       ui unsigned int

       ul unsigned long

       uq unsigned long long

EXIT STATUS

       The following values are returned on exit:

       0 SUCCESS
	      The input was successfully converted.

       1 INFO The user requested information such as the version number or usage synopsis and this has been provided.

       2 SYSTEM ERROR
	      An error resulted from a failure of the operating system such as an i/o error or inability to allocate storage.

       3 COMMAND LINE ERROR
	      The program was called with invalid or inconsistent command line flags.

       5 INPUT ERROR
	      This means that the input was ill-formed, that is that it could not be interpreted as a number of the required type. For example, if
	      the input is 0x2A and a decimal value is called for,  an INPUT ERROR will be returned since 0x2A is not a valid representation of  a
	      decimal integer.

AUTHOR

       Bill Poser (billposer@alum.mit.edu)

LICENSE

       GNU General Public License, version 3

SEE ALSO

       ascii2binary(1)

								    July, 2010							   binary2ascii(1)