m.examine.tape(1)      Grass User's Manual	m.examine.tape(1)



NNAAMMEE
       mm..eexxaammiinnee..ttaappee  - Provides a description of the files on a
       1/2-inch magnetic tape.
       _(_G_R_A_S_S _F_i_l_e _M_a_n_a_g_e_m_e_n_t _T_o_o_l_)

SSYYNNOOPPSSIISS
       mm..eexxaammiinnee..ttaappee

DDEESSCCRRIIPPTTIIOONN
       _m_._e_x_a_m_i_n_e_._t_a_p_e is a convenient tool for previewing a  tape
       and  obtaining  block  size values.  After the user enters
       the command mm..eexxaammiinnee..ttaappee

       the program will prompt the user for the full path name of
       the  tape  device  on  which the tape is mounted.  In most
       cases, this will be /dev/rmt0.	However,  the  user  must
       enter  this,  as  there	is  no default value for the tape
       device name.  The user  is  then  prompted  to  enter  the
       buffer  size to be used when reading the tape.  The buffer
       size is the amount of memory allocated to read one  physi-
       cal record of the tape.	If the user hits RETURN, the pro-
       gram will assume a default buffer size of 32767 bytes.


       _m_._e_x_a_m_i_n_e_._t_a_p_e reads the tape specified by  the	user  and
       reports back the block size (record length) and the number
       of blocks for each file contained on  the  tape.   _m_._e_x_a_m_-
       _i_n_e_._t_a_p_e  can  be used on any 1/2-inch magnetic tape.  The
       user has the option of sending the output into a  file  or
       viewing the output on the terminal screen.

NNOOTTEESS
       The  buffer size is the amount of memory allocated to read
       one physical record on the tape.   Magnetic  tape  devices
       will  accept  a	request  to read more bytes than actually
       exist in any given record on  a	tape.	However,  _m_._e_x_a_m_-
       _i_n_e_._t_a_p_e  reads	only as many bytes as physically exist on
       the tape and returns the number of  bytes  actually  read.
       The  user  is allowed to alter the buffer size in order to
       request smaller reads for tape devices  unable  to  handle
       requests  this  large  (32767 bytes), or to request larger
       reads for tapes with larger record sizes  read  on  drives
       able to handle larger record sizes.


       Note  that  _m_._e_x_a_m_i_n_e_._t_a_p_e  cannot  be used to examine the
       content of either ordinary files  or  1/4-inch  tape  car-
       tridges.

SSEEEE AALLSSOO
       _m_._d_e_m_._e_x_a_m_i_n_e

       _m_._d_e_m_._e_x_t_r_a_c_t

       _m_._d_m_a_U_S_G_S_r_e_a_d

       _m_._d_t_e_d_._e_x_a_m_i_n_e

       _m_._d_t_e_d_._e_x_t_r_a_c_t

       _m_._l_u_l_c_._U_S_G_S

       _m_._l_u_l_c_._r_e_a_d

AAUUTTHHOORR
       Michael	 Shapiro,   U.S.Army   Construction   Engineering
       Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0					m.examine.tape(1)
