sg3_utils/include/sg_cmds_basic.h - backupdr - Git at Google

 #ifndef SG_CMDS_BASIC_H
 #define SG_CMDS_BASIC_H

 /*
  * Copyright (c) 2004-2014 Douglas Gilbert.
  * All rights reserved.
  * Use of this source code is governed by a BSD-style
  * license that can be found in the BSD_LICENSE file.
  */

 /*
  * Error, warning and verbose output is sent to the file pointed to by
  * sg_warnings_strm which is declared in sg_lib.h and can be set with
  * the sg_set_warnings_strm() function. If not given sg_warnings_strm
  * defaults to stderr.
  * If 'noisy' and 'verbose' are both zero then following functions should
  * not output anything to sg_warnings_strm. If 'noisy' is non-zero and
  * 'verbose' is zero then Unit Attention, Recovered, Medium and Hardware
  * errors (sense keys) send output to sg_warnings_strm. Increasing values
  * of 'verbose' send increasing amounts of (debug) output to
  * sg_warnings_strm.
  */

 #ifdef __cplusplus
 extern "C" {
 #endif


 /* Invokes a SCSI INQUIRY command and yields the response
  * Returns 0 when successful, SG_LIB_CAT_INVALID_OP -> not supported,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb,
  * SG_LIB_CAT_ABORTED_COMMAND, -1 -> other errors */
 int sg_ll_inquiry(int sg_fd, int cmddt, int evpd, int pg_op, void * resp,
                   int mx_resp_len, int noisy, int verbose);

 /* Invokes a SCSI LOG SELECT command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> Log Select not supported,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_ABORTED_COMMAND, * SG_LIB_CAT_NOT_READY -> device not ready,
  * -1 -> other failure */
 int sg_ll_log_select(int sg_fd, int pcr, int sp, int pc, int pg_code,
                      int subpg_code, unsigned char * paramp, int param_len,
                      int noisy, int verbose);

 /* Invokes a SCSI LOG SENSE command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> Log Sense not supported,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_log_sense(int sg_fd, int ppc, int sp, int pc, int pg_code,
                     int subpg_code, int paramp, unsigned char * resp,
                     int mx_resp_len, int noisy, int verbose);

 /* Invokes a SCSI MODE SELECT (6) command.  Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
  * bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
  * SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_mode_select6(int sg_fd, int pf, int sp, void * paramp,
                         int param_len, int noisy, int verbose);

 /* Invokes a SCSI MODE SELECT (10) command.  Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
  * bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
  * SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_mode_select10(int sg_fd, int pf, int sp, void * paramp,
                         int param_len, int noisy, int verbose);

 /* Invokes a SCSI MODE SENSE (6) command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
  * bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
  * SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_mode_sense6(int sg_fd, int dbd, int pc, int pg_code,
                       int sub_pg_code, void * resp, int mx_resp_len,
                       int noisy, int verbose);

 /* Invokes a SCSI MODE SENSE (10) command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
  * bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
  * SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_mode_sense10(int sg_fd, int llbaa, int dbd, int pc, int pg_code,
                        int sub_pg_code, void * resp, int mx_resp_len,
                        int noisy, int verbose);

 /* Invokes a SCSI PREVENT ALLOW MEDIUM REMOVAL command (SPC-3)
  * prevent==0 allows removal, prevent==1 prevents removal ...
  * Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> command not supported
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_prevent_allow(int sg_fd, int prevent, int noisy, int verbose);

 /* Invokes a SCSI READ CAPACITY (10) command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_UNIT_ATTENTION
  * -> perhaps media changed, SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb,
  * SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_readcap_10(int sg_fd, int pmi, unsigned int lba, void * resp,
                      int mx_resp_len, int noisy, int verbose);

 /* Invokes a SCSI READ CAPACITY (16) command. Returns 0 -> success,
  * SG_LIB_CAT_UNIT_ATTENTION -> media changed??, SG_LIB_CAT_INVALID_OP
  *  -> cdb not supported, SG_LIB_CAT_IlLEGAL_REQ -> bad field in cdb
  * SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_readcap_16(int sg_fd, int pmi, uint64_t llba, void * resp,
                      int mx_resp_len, int noisy, int verbose);

 /* Invokes a SCSI REPORT LUNS command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> Report Luns not supported,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_ABORTED_COMMAND,
  * SG_LIB_NOT_READY (shouldn't happen), -1 -> other failure */
 int sg_ll_report_luns(int sg_fd, int select_report, void * resp,
                       int mx_resp_len, int noisy, int verbose);

 /* Invokes a SCSI REQUEST SENSE command. Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> Request Sense not supported??,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure */
 int sg_ll_request_sense(int sg_fd, int desc, void * resp, int mx_resp_len,
                         int noisy, int verbose);

 /* Invokes a SCSI START STOP UNIT command (SBC + MMC).
  * Return of 0 -> success,
  * SG_LIB_CAT_INVALID_OP -> Start stop unit not supported,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other failure
  * SBC-3 and MMC partially overlap on the power_condition_modifier(sbc) and
  * format_layer_number(mmc) fields. They also overlap on the noflush(sbc)
  * and fl(mmc) one bit field. This is the cause of the awkardly named
  * pc_mod__fl_num and noflush__fl arguments to this function.  */
 int sg_ll_start_stop_unit(int sg_fd, int immed, int pc_mod__fl_num,
                           int power_cond, int noflush__fl, int loej,
                           int start, int noisy, int verbose);

 /* Invokes a SCSI SYNCHRONIZE CACHE (10) command. Return of 0 -> success,
  * SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
  * SG_LIB_CAT_INVALID_OP -> cdb not supported,
  * SG_LIB_CAT_IlLEGAL_REQ -> bad field in cdb
  * SG_LIB_CAT_NOT_READY -> device not ready, -1 -> other failure */
 int sg_ll_sync_cache_10(int sg_fd, int sync_nv, int immed, int group,
                         unsigned int lba, unsigned int count, int noisy,
                         int verbose);

 /* Invokes a SCSI TEST UNIT READY command.
  * 'pack_id' is just for diagnostics, safe to set to 0.
  * Return of 0 -> success, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_NOT_READY -> device not ready,
  * SG_LIB_CAT_ABORTED_COMMAND, -1 -> other failure */
 int sg_ll_test_unit_ready(int sg_fd, int pack_id, int noisy, int verbose);

 /* Invokes a SCSI TEST UNIT READY command.
  * 'pack_id' is just for diagnostics, safe to set to 0.
  * Looks for progress indicator if 'progress' non-NULL;
  * if found writes value [0..65535] else write -1.
  * Return of 0 -> success, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_ABORTED_COMMAND, SG_LIB_CAT_NOT_READY ->
  * device not ready, -1 -> other failure */
 int sg_ll_test_unit_ready_progress(int sg_fd, int pack_id, int * progress,
                                    int noisy, int verbose);


 struct sg_simple_inquiry_resp {
     unsigned char peripheral_qualifier;
     unsigned char peripheral_type;
     unsigned char byte_1;       /* was 'rmb' prior to version 1.39 */
                                 /* now rmb == !!(0x80 & byte_1) */
     unsigned char version;      /* as per recent drafts: whole of byte 2 */
     unsigned char byte_3;
     unsigned char byte_5;
     unsigned char byte_6;
     unsigned char byte_7;
     char vendor[9];             /* T10 field is 8 bytes, NUL char appended */
     char product[17];
     char revision[5];
 };

 /* Yields most of first 36 bytes of a standard INQUIRY (evpd==0) response.
  * Returns 0 when successful, SG_LIB_CAT_INVALID_OP -> not supported,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_ABORTED_COMMAND,
  * -1 -> other errors */
 int sg_simple_inquiry(int sg_fd, struct sg_simple_inquiry_resp * inq_data,
                       int noisy, int verbose);

 /* MODE SENSE commands yield a response that has block descriptors followed
  * by mode pages. In most cases users are interested in the first mode page.
  * This function returns the (byte) offset of the start of the first mode
  * page. Set mode_sense_6 to 1 for MODE SENSE (6) and 0 for MODE SENSE (10).
  * Returns >= 0 is successful or -1 if failure. If there is a failure
  * a message is written to err_buff. */
 int sg_mode_page_offset(const unsigned char * resp, int resp_len,
                         int mode_sense_6, char * err_buff, int err_buff_len);

 /* Fetches current, changeable, default and/or saveable modes pages as
  * indicated by pcontrol_arr for given pg_code and sub_pg_code. If
  * mode6==0 then use MODE SENSE (10) else use MODE SENSE (6). If
  * flexible set and mode data length seems wrong then try and
  * fix (compensating hack for bad device or driver). pcontrol_arr
  * should have 4 elements for output of current, changeable, default
  * and saved values respectively. Each element should be NULL or
  * at least mx_mpage_len bytes long.
  * Return of 0 -> overall success, SG_LIB_CAT_INVALID_OP -> invalid opcode,
  * SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
  * SG_LIB_CAT_NOT_READY -> device not ready,
  * SG_LIB_CAT_MALFORMED -> bad response, -1 -> other failure.
  * If success_mask pointer is not NULL then first zeros it. Then set bits
  * 0, 1, 2 and/or 3 if the current, changeable, default and saved values
  * respectively have been fetched. If error on current page
  * then stops and returns that error; otherwise continues if an error is
  * detected but returns the first error encountered.  */
 int sg_get_mode_page_controls(int sg_fd, int mode6, int pg_code,
                               int sub_pg_code, int dbd, int flexible,
                               int mx_mpage_len, int * success_mask,
                               void * pcontrol_arr[], int * reported_len,
                               int verbose);

 /* Returns file descriptor >= 0 if successful. If error in Unix returns
    negated errno. Implementation calls scsi_pt_open_device(). */
 int sg_cmds_open_device(const char * device_name, int read_only, int verbose);

 /* Returns file descriptor >= 0 if successful. If error in Unix returns
    negated errno. Implementation calls scsi_pt_open_flags(). */
 int sg_cmds_open_flags(const char * device_name, int flags, int verbose);

 /* Returns 0 if successful. If error in Unix returns negated errno.
    Implementation calls scsi_pt_close_device(). */
 int sg_cmds_close_device(int device_fd);

 const char * sg_cmds_version();


 struct sg_pt_base;

 /* This is a helper function used by sg_cmds_* implementations after the
  * call to the pass-through. pt_res is returned from do_scsi_pt(). If valid
  * sense data is found it is decoded and output to sg_warnings_strm (def:
  * stderr); depending on the 'noisy' and 'verbose' settings. Returns -2 for
  * sense data (may not be fatal), -1 for failed, 0, or a positive number. If
  * 'mx_di_len > 0' then asks pass-through for resid and returns
  * (mx_di_len - resid); otherwise returns 0. So for data-in it should return
  * the actual number of bytes received. For data-out (to device) or no data
  * call with 'mx_di_len' set to 0 or less. If -2 returned then sense category
  * output via 'o_sense_cat' pointer (if not NULL). Note that several sense
  * categories also have data in bytes received; -2 is still returned. */
 int sg_cmds_process_resp(struct sg_pt_base * ptvp, const char * leadin,
                          int pt_res, int mx_di_len,
                          const unsigned char * sense_b, int noisy,
                          int verbose, int * o_sense_cat);

 #ifdef __cplusplus
 }
 #endif

 #endif
	#ifndef SG_CMDS_BASIC_H
	#define SG_CMDS_BASIC_H

	/*
	* Copyright (c) 2004-2014 Douglas Gilbert.
	* All rights reserved.
	* Use of this source code is governed by a BSD-style
	* license that can be found in the BSD_LICENSE file.
	*/

	/*
	* Error, warning and verbose output is sent to the file pointed to by
	* sg_warnings_strm which is declared in sg_lib.h and can be set with
	* the sg_set_warnings_strm() function. If not given sg_warnings_strm
	* defaults to stderr.
	* If 'noisy' and 'verbose' are both zero then following functions should
	* not output anything to sg_warnings_strm. If 'noisy' is non-zero and
	* 'verbose' is zero then Unit Attention, Recovered, Medium and Hardware
	* errors (sense keys) send output to sg_warnings_strm. Increasing values
	* of 'verbose' send increasing amounts of (debug) output to
	* sg_warnings_strm.
	*/

	#ifdef __cplusplus
	extern "C" {
	#endif


	/* Invokes a SCSI INQUIRY command and yields the response
	* Returns 0 when successful, SG_LIB_CAT_INVALID_OP -> not supported,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb,
	* SG_LIB_CAT_ABORTED_COMMAND, -1 -> other errors */
	int sg_ll_inquiry(int sg_fd, int cmddt, int evpd, int pg_op, void * resp,
	int mx_resp_len, int noisy, int verbose);

	/* Invokes a SCSI LOG SELECT command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> Log Select not supported,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_ABORTED_COMMAND, * SG_LIB_CAT_NOT_READY -> device not ready,
	* -1 -> other failure */
	int sg_ll_log_select(int sg_fd, int pcr, int sp, int pc, int pg_code,
	int subpg_code, unsigned char * paramp, int param_len,
	int noisy, int verbose);

	/* Invokes a SCSI LOG SENSE command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> Log Sense not supported,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_log_sense(int sg_fd, int ppc, int sp, int pc, int pg_code,
	int subpg_code, int paramp, unsigned char * resp,
	int mx_resp_len, int noisy, int verbose);

	/* Invokes a SCSI MODE SELECT (6) command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
	* bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
	* SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_mode_select6(int sg_fd, int pf, int sp, void * paramp,
	int param_len, int noisy, int verbose);

	/* Invokes a SCSI MODE SELECT (10) command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
	* bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
	* SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_mode_select10(int sg_fd, int pf, int sp, void * paramp,
	int param_len, int noisy, int verbose);

	/* Invokes a SCSI MODE SENSE (6) command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
	* bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
	* SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_mode_sense6(int sg_fd, int dbd, int pc, int pg_code,
	int sub_pg_code, void * resp, int mx_resp_len,
	int noisy, int verbose);

	/* Invokes a SCSI MODE SENSE (10) command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_ILLEGAL_REQ ->
	* bad field in cdb, * SG_LIB_CAT_NOT_READY -> device not ready,
	* SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_mode_sense10(int sg_fd, int llbaa, int dbd, int pc, int pg_code,
	int sub_pg_code, void * resp, int mx_resp_len,
	int noisy, int verbose);

	/* Invokes a SCSI PREVENT ALLOW MEDIUM REMOVAL command (SPC-3)
	* prevent==0 allows removal, prevent==1 prevents removal ...
	* Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> command not supported
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_prevent_allow(int sg_fd, int prevent, int noisy, int verbose);

	/* Invokes a SCSI READ CAPACITY (10) command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> invalid opcode, SG_LIB_CAT_UNIT_ATTENTION
	* -> perhaps media changed, SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb,
	* SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_readcap_10(int sg_fd, int pmi, unsigned int lba, void * resp,
	int mx_resp_len, int noisy, int verbose);

	/* Invokes a SCSI READ CAPACITY (16) command. Returns 0 -> success,
	* SG_LIB_CAT_UNIT_ATTENTION -> media changed??, SG_LIB_CAT_INVALID_OP
	* -> cdb not supported, SG_LIB_CAT_IlLEGAL_REQ -> bad field in cdb
	* SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_readcap_16(int sg_fd, int pmi, uint64_t llba, void * resp,
	int mx_resp_len, int noisy, int verbose);

	/* Invokes a SCSI REPORT LUNS command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> Report Luns not supported,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_ABORTED_COMMAND,
	* SG_LIB_NOT_READY (shouldn't happen), -1 -> other failure */
	int sg_ll_report_luns(int sg_fd, int select_report, void * resp,
	int mx_resp_len, int noisy, int verbose);

	/* Invokes a SCSI REQUEST SENSE command. Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> Request Sense not supported??,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure */
	int sg_ll_request_sense(int sg_fd, int desc, void * resp, int mx_resp_len,
	int noisy, int verbose);

	/* Invokes a SCSI START STOP UNIT command (SBC + MMC).
	* Return of 0 -> success,
	* SG_LIB_CAT_INVALID_OP -> Start stop unit not supported,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_NOT_READY -> device not ready, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other failure
	* SBC-3 and MMC partially overlap on the power_condition_modifier(sbc) and
	* format_layer_number(mmc) fields. They also overlap on the noflush(sbc)
	* and fl(mmc) one bit field. This is the cause of the awkardly named
	* pc_mod__fl_num and noflush__fl arguments to this function. */
	int sg_ll_start_stop_unit(int sg_fd, int immed, int pc_mod__fl_num,
	int power_cond, int noflush__fl, int loej,
	int start, int noisy, int verbose);

	/* Invokes a SCSI SYNCHRONIZE CACHE (10) command. Return of 0 -> success,
	* SG_LIB_CAT_UNIT_ATTENTION, SG_LIB_CAT_ABORTED_COMMAND,
	* SG_LIB_CAT_INVALID_OP -> cdb not supported,
	* SG_LIB_CAT_IlLEGAL_REQ -> bad field in cdb
	* SG_LIB_CAT_NOT_READY -> device not ready, -1 -> other failure */
	int sg_ll_sync_cache_10(int sg_fd, int sync_nv, int immed, int group,
	unsigned int lba, unsigned int count, int noisy,
	int verbose);

	/* Invokes a SCSI TEST UNIT READY command.
	* 'pack_id' is just for diagnostics, safe to set to 0.
	* Return of 0 -> success, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_NOT_READY -> device not ready,
	* SG_LIB_CAT_ABORTED_COMMAND, -1 -> other failure */
	int sg_ll_test_unit_ready(int sg_fd, int pack_id, int noisy, int verbose);

	/* Invokes a SCSI TEST UNIT READY command.
	* 'pack_id' is just for diagnostics, safe to set to 0.
	* Looks for progress indicator if 'progress' non-NULL;
	* if found writes value [0..65535] else write -1.
	* Return of 0 -> success, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_ABORTED_COMMAND, SG_LIB_CAT_NOT_READY ->
	* device not ready, -1 -> other failure */
	int sg_ll_test_unit_ready_progress(int sg_fd, int pack_id, int * progress,
	int noisy, int verbose);


	struct sg_simple_inquiry_resp {
	unsigned char peripheral_qualifier;
	unsigned char peripheral_type;
	unsigned char byte_1; /* was 'rmb' prior to version 1.39 */
	/* now rmb == !!(0x80 & byte_1) */
	unsigned char version; /* as per recent drafts: whole of byte 2 */
	unsigned char byte_3;
	unsigned char byte_5;
	unsigned char byte_6;
	unsigned char byte_7;
	char vendor[9]; /* T10 field is 8 bytes, NUL char appended */
	char product[17];
	char revision[5];
	};

	/* Yields most of first 36 bytes of a standard INQUIRY (evpd==0) response.
	* Returns 0 when successful, SG_LIB_CAT_INVALID_OP -> not supported,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_ABORTED_COMMAND,
	* -1 -> other errors */
	int sg_simple_inquiry(int sg_fd, struct sg_simple_inquiry_resp * inq_data,
	int noisy, int verbose);

	/* MODE SENSE commands yield a response that has block descriptors followed
	* by mode pages. In most cases users are interested in the first mode page.
	* This function returns the (byte) offset of the start of the first mode
	* page. Set mode_sense_6 to 1 for MODE SENSE (6) and 0 for MODE SENSE (10).
	* Returns >= 0 is successful or -1 if failure. If there is a failure
	* a message is written to err_buff. */
	int sg_mode_page_offset(const unsigned char * resp, int resp_len,
	int mode_sense_6, char * err_buff, int err_buff_len);

	/* Fetches current, changeable, default and/or saveable modes pages as
	* indicated by pcontrol_arr for given pg_code and sub_pg_code. If
	* mode6==0 then use MODE SENSE (10) else use MODE SENSE (6). If
	* flexible set and mode data length seems wrong then try and
	* fix (compensating hack for bad device or driver). pcontrol_arr
	* should have 4 elements for output of current, changeable, default
	* and saved values respectively. Each element should be NULL or
	* at least mx_mpage_len bytes long.
	* Return of 0 -> overall success, SG_LIB_CAT_INVALID_OP -> invalid opcode,
	* SG_LIB_CAT_ILLEGAL_REQ -> bad field in cdb, SG_LIB_CAT_UNIT_ATTENTION,
	* SG_LIB_CAT_NOT_READY -> device not ready,
	* SG_LIB_CAT_MALFORMED -> bad response, -1 -> other failure.
	* If success_mask pointer is not NULL then first zeros it. Then set bits
	* 0, 1, 2 and/or 3 if the current, changeable, default and saved values
	* respectively have been fetched. If error on current page
	* then stops and returns that error; otherwise continues if an error is
	* detected but returns the first error encountered. */
	int sg_get_mode_page_controls(int sg_fd, int mode6, int pg_code,
	int sub_pg_code, int dbd, int flexible,
	int mx_mpage_len, int * success_mask,
	void * pcontrol_arr[], int * reported_len,
	int verbose);

	/* Returns file descriptor >= 0 if successful. If error in Unix returns
	negated errno. Implementation calls scsi_pt_open_device(). */
	int sg_cmds_open_device(const char * device_name, int read_only, int verbose);

	/* Returns file descriptor >= 0 if successful. If error in Unix returns
	negated errno. Implementation calls scsi_pt_open_flags(). */
	int sg_cmds_open_flags(const char * device_name, int flags, int verbose);

	/* Returns 0 if successful. If error in Unix returns negated errno.
	Implementation calls scsi_pt_close_device(). */
	int sg_cmds_close_device(int device_fd);

	const char * sg_cmds_version();


	struct sg_pt_base;

	/* This is a helper function used by sg_cmds_* implementations after the
	* call to the pass-through. pt_res is returned from do_scsi_pt(). If valid
	* sense data is found it is decoded and output to sg_warnings_strm (def:
	* stderr); depending on the 'noisy' and 'verbose' settings. Returns -2 for
	* sense data (may not be fatal), -1 for failed, 0, or a positive number. If
	* 'mx_di_len > 0' then asks pass-through for resid and returns
	* (mx_di_len - resid); otherwise returns 0. So for data-in it should return
	* the actual number of bytes received. For data-out (to device) or no data
	* call with 'mx_di_len' set to 0 or less. If -2 returned then sense category
	* output via 'o_sense_cat' pointer (if not NULL). Note that several sense
	* categories also have data in bytes received; -2 is still returned. */
	int sg_cmds_process_resp(struct sg_pt_base * ptvp, const char * leadin,
	int pt_res, int mx_di_len,
	const unsigned char * sense_b, int noisy,
	int verbose, int * o_sense_cat);

	#ifdef __cplusplus
	}
	#endif

	#endif