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 physical record of the tape.  If
       the  user hits RETURN, the program 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 mag-
       netic  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 cartridges.

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)
