Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ () — Motorola System V 88k Release 3.2 Version 1.2C

Media Vault

Software Library

Restoration Projects

Artifacts Sought



  XFORMTRK(1M)          (UniSoft Value Added)          XFORMTRK(1M)



  NAME
       xformtrk - convert bad track list from one format to another

  SYNOPSIS
       xformtrk -I opt -O opt [-t file] [-d ddefsdir] devtype
       device

  DESCRIPTION
       xformtrk converts the input data, in any of the three input
       formats (track; head,cylinder pairs; logical-device,block
       pairs), to a file containing values in either track or
       head,cylinder format.  All input entries must be in the same
       format and, for any format, must be one number or pair per
       line.  For example:
        tracks:   head,cyl pair:   logical-dev,block offset pair:
         1501         4 1234                  11 1234
         2345         6 9182                  73 5678

       The output from xformtrk goes into the file /tmp/xfdevice
       in a format suitable as input for fblkgen(1M).  The file is
       removed next time the system is rebooted; it should,
       therefore, be moved to a more permanent place if you wish to
       keep it.  If a file /tmp/xfdevice already exists, it is
       overwritten.

       fblkgen discards those input values having corresponding
       track numbers which are less than zero or larger than the
       maximum as computed from entries in /etc/dskdefs/devtype.

       Values for the logical-device,block offset format normally
       come from the output of errpt(1M).  The two fields of
       interest are:

       Logical Device                    <decimal #>   (<octal #>)
       Block No. in Logical Filesystem   <decimal #>
                                         (in 512-byte blocks, beginning with 0)

       Always use the decimal value of ``logical device'' as input
       to xformtrk.



  Page 1                                                   May 1989


















  XFORMTRK(1M)          (UniSoft Value Added)          XFORMTRK(1M)



       The options are:

       -I opt    Specify the input as either t for track; c for
                 head,cylinder pairs; or d for logical-device,block
                 pairs, one entry per line.  For head,cylinder
                 pairs, do not input the byte offset or BFI (bytes
                 from index).

       -O opt    Specify the output as either t for track or c for
                 head,cylinder pairs, one entry per line.

       -t file   Use the named file as input.  The format is either
                 single track numbers; head,cylinder pairs; or
                 logical-device,block offset pairs, one number or
                 pair per line. For head,cylinder pairs, do not
                 input the byte offset or BFI (bytes from index).
                 When the -t option is omitted, you are prompted to
                 enter the data manually.

       -d ddefsdir
                 Use the directory ddefsdir rather than
                 /etc/dskdefs/ to find the entry for devtype.

       devtype   This is the device type found in /etc/dskdefs
                 which uniquely identifies the device (e.g.,
                 m323182).  See ddefs(1M).

       device    The disk device name of the form x_y, where x is
                 the controller and y is the drive logical unit
                 number on that controller (e.g., m323_0).  For
                 device-naming conventions, see Appendix A in the
                 System Administrator's Guide.

  EXAMPLE
       Convert the file badtrkfile from track numbers to head,
       cylinder pairs with the numbers referencing the first CDC
       WREN disk attached to the MVME323 controller.

                  xformtrk -I t -O c -t badtrkfile m323182 m323_0



  Page 2                                                   May 1989


















  XFORMTRK(1M)          (UniSoft Value Added)          XFORMTRK(1M)



  SEE ALSO
       fblkgen(1M).

  FILES
       /etc/dskdefs/*
       /tmp/xf.device

  DIAGNOSTICS
       Exit Codes:

            0 - success

            1 - internal failure        unknown type or device,
                                        general error

            2 - I/O failure             files not found, read/write
                                        failure, etc.

            3 - bad command usage       syntax error within command
                                        line

            4 - user interrupt


















  Page 3                                                   May 1989


















Typewritten Software • bear@typewritten.org • Edmonds, WA 98026