+/***************************************************************/
+/*!
+ *\brief Query the block's state.
+ *
+ * If the state is not TBS_OK, the block must be discarded.
+ *\return The block's initialisation state
+ */
+tape_block::tb_state_t tape_block::get_state(){
+ return init_state;
+}
+
+/***************************************************************/
+/*!
+ *\brief Determine the block's type
+ *
+ * This routine returns the block's type.\\
+ *\retval TBT_DATA if it's a data block
+ *\retval TBT_EOT if it's an end of tape mark
+ *\retval TBR_DISCARD if the block is unusable
+ *
+ *\note This function is virtual. That means that if the tape block in
+ * question is of the subtype data_block which overwrites this method,
+ * it will return the block type contained in the upper 4 bits of the
+ * first data word! Try to avoid testing for TBT_DATA. \n
+ * Blocks generated by gen_from_fd should never have TBT_DATA.
+ */
+int tape_block::get_type(){
+ return block_type;
+}
+
+/***************************************************************/
+/*!
+ *\brief Determine the block's subtype
+ *
+ * Some data block types have a subtype.
+ *\note This is a virtual method and to be used in derived classes.
+ *\return Always 0
+ */
+int tape_block::get_subtype(){
+ return 0;
+}
+
+/***************************************************************/
+/*!
+ *\brief Get a cleartext description of the block.
+ *\return ldc style descriptive line for the block
+ */
+vector<string> tape_block:: get_description(){
+ vector<string> result;
+ result.insert(result.end(),
+ "***** "+get_typestring()+"Untyped tape block");
+ return result;
+}
+
+/***************************************************************/
+/*!
+ *\brief Get size of the internal raw data buffer
+ *\return The size of the internal raw data buffer
+ */
+int tape_block::get_raw_size(){
+ return raw_size;
+}
+
+/***************************************************************/
+/*!
+ *\brief Access internal raw data buffer
+ *
+ * The raw data buffer contains all block data except the \ \
+ * block start delimiter and block end delimiter.
+ *\return Pointer to internal raw data buffer of the block
+ */
+unsigned char * tape_block::get_raw_data(){
+ return raw_data;
+}
+
+/***************************************************************/
+/*!
+ *\brief Static factory method with file descriptor support.
+ *
+ * This method creates a tape_block by using the private
+ * constructor with file descriptor support.\n
+ * It always returns a valid pointer, errors
+ * or exceptional conditions during creation are marked in the
+ * object's state.\n
+ * The factory method tries to determine the block's type and then
+ * looks for appropriate subclasses. If there's an appropriate
+ * subclass fitting the newly-created object, an
+ * object of the subclass will be created and a pointer to this
+ * object will be returned to the caller.\n
+ * This allows for easy use of the object using it's virtual
+ * interface methods or a cast of the pointer to a sub type pointer
+ * according to the type information, and then using the subtype's
+ * methods not already present in tape_block.\n
+ * Objects of the following subclasses are automagically generated:\n
+ * - eot_block
+ * - discard_block
+ * - data_block
+ * - data_block_0
+ * - data_block_0_0
+ * - data_block_0_1
+ * - data_block_0_2
+ * - data_block_0_3
+ * - data_block_0_4
+ * - data_block_0_10
+ * - data_block_0_14
+ * - data_block_0_24
+ * - data_block_0_30
+ * - data_block_0_50
+ * - data_block_0_54
+ * - data_block_0_60
+ * - data_block_1
+ * - data_block_2
+ * - data_block_3
+ * - data_block_4
+ * - data_block_5
+ * - data_block_6
+ * - data_block_7
+ *
+ *\return Pointer to an object of type tape_block or a subclass.
+ *\param fd A file descriptor where the read is taken from.
+ *\param input_start A pointer to a function
+ * called before reading data from fd.
+ *\param input_stop A pointer to a function
+ * called after reading data from fd.
+ *
+ *\param start_stop_arg A pointer passed to input_start
+ * and input_stop(). Can be anything.
+ */
+tape_block * tape_block::gen_from_fd(int fd,
+ void(*input_start)(void *),
+ void (*input_stop)(void *),
+ void * start_stop_arg)
+{
+ tape_block * res_block;
+ res_block=new tape_block(fd,input_start,input_stop,start_stop_arg);
+ data_block * d_block;
+ data_block_0 * d0_block;
+ eot_block * e_block;
+ discard_block * di_block;
+
+ // Retype to data_block if possible
+ switch(res_block->get_type()){
+ case tape_block::TBT_DATA: // Make pointer a data block
+ d_block=new data_block(*res_block);
+ delete res_block;
+ res_block=d_block;
+ break;
+ case tape_block::TBT_EOT:
+ e_block=new eot_block(*res_block);
+ delete res_block;
+ res_block=e_block;
+ break;
+ case tape_block::TBT_DISCARD:
+ di_block=new discard_block(*res_block);
+ delete res_block;
+ res_block=di_block;
+ break;
+ default: // All other cases
+ return res_block;
+ }
+
+ // Retype again, if it's a data_block now
+
+ switch(res_block->get_type()){
+ case 00:
+ d0_block=new data_block_0(*d_block);
+ d_block=d0_block;
+ break;
+// case 01: d_block=new data_block_1(*d_block); break;
+// case 02: d_block=new data_block_2(*d_block); break;
+// case 03: d_block=new data_block_3(*d_block); break;
+// case 04: d_block=new data_block_4(*d_block); break;
+// case 05: d_block=new data_block_5(*d_block); break;
+// case 06: d_block=new data_block_6(*d_block); break;
+// case 07: d_block=new data_block_7(*d_block); break;
+ default:
+ return res_block;
+ }
+ delete res_block;
+ res_block=d_block;
+
+ if (res_block->get_type()==0) switch(d0_block->get_subtype()){
+ case 000: d0_block=new data_block_0_0(*d0_block); break;
+ case 001: d0_block=new data_block_0_1(*d0_block); break;
+ case 002: d0_block=new data_block_0_2(*d0_block); break;
+ case 003: d0_block=new data_block_0_3(*d0_block); break;
+ case 004: d0_block=new data_block_0_4(*d0_block); break;
+ case 010: d0_block=new data_block_0_10(*d0_block); break;
+ case 014: d0_block=new data_block_0_14(*d0_block); break;
+ case 024: d0_block=new data_block_0_24(*d0_block); break;
+ case 044: d0_block=new data_block_0_44(*d0_block); break;
+ case 030: d0_block=new data_block_0_30(*d0_block); break;
+ case 054: d0_block=new data_block_0_54(*d0_block); break;
+ case 060: d0_block=new data_block_0_60(*d0_block); break;
+ case 050: d0_block=new data_block_0_50(*d0_block); break;
+ default:
+ return res_block;
+ }
+ delete res_block;
+ res_block=d0_block;
+
+ return res_block;
+}
+
+/***************************************************************/
+/*!
+ *\brief Default constructor.
+ */
+tape_block::tape_block(){}
+
+/***************************************************************/
+/*!
+ *\brief get a short type description string.
+ *\return A small string to be used in description methods.
+ *
+ * The string is always 19 characters long.\n
+ * An example is "(99-99) ".
+ */
+string tape_block::get_typestring(){
+ char buffer[13];
+ sprintf(buffer,"(%o-%o) ",get_type(),get_subtype());
+ buffer[10]=0;
+ return string(buffer);
+}
+
+/***************************************************************/
+/*!
+ *\brief Automatic constructor with file descriptor support
+ *
+ * This constructor is used to initialise the block read in the block's
+ * data via a file descriptor.\n
+ * This is done in the following way:
+ * - input_start() is called.
+ * - Data is read from fd. Stops on end of file or end of block
+ * or IO error. On EOF or IO error input_stop() is NOT called.
+ * - If there was no IO error the block's checksum is calculated
+ * and checked.
+ * - The block's type field is initialised.
+ * - input_stop() is called.
+ *
+ *\param fd A file descriptor where the read is taken from
+ *\param input_stop A pointer to a function called at the end of input
+ *\param input_start A pointer to a function called at the beginning
+ * of input
+ *\param start_stop_arg A pointer passed to input_start and input_stop().
+ */