| This directory contains these utilities: | |
| - hxascdmp: takes a binary stream and converts it to hexadecimal ASCII | |
| which is sent to stdout. The incoming binary stream can either be | |
| from a file or, in the absence of a file name, from stdin. Similar to | |
| the Unix "od" command. By default, it decodes 16 bytes per line with | |
| an ASCII interpretation to the right of each line. See its | |
| hxascdmp(1) man page. | |
| - sg_chk_asc: utility decodes the SCSI additional sense code table | |
| found at http://www.t10.org/lists/asc-num.txt and checks it | |
| against the table found in sg_lib_data.c in the lib/ subdirectory. | |
| It is designed to keep the table in sg_lib_data.c in "sync" with the | |
| table at the t10.org web site. | |
| By default, the Makefile only builds the hxascdmp utility. The 'Makefile' | |
| file (i.e. with no suffix) builds for Linux; the 'Makefile.freebsd' file | |
| builds for FreeBSD (e.g. 'make -f Makefile.freebsd'); the | |
| 'Makefile.solaris' file builds for Solaris; the 'Makefile.mingw' builds | |
| in the Windows MinGW environment (e.g. msys shell); and 'Makefile.cygwin' | |
| builds in the Windows Cygwin environment. | |
| To build sg_chk_asc the sg_lib.o and sg_lib_data.o files must be present | |
| (i.e. compiled) in the lib/ subdirectory. One way to meet that requirement | |
| is to execute './configure' in the main directory then 'cd lib ; make '. | |
| Then return to this directory and do 'make sg_chk_asc'. | |
| Douglas Gilbert | |
| 30th March 2010 |