1libdskrc(5)                        Emulators                       libdskrc(5)
2
3
4

NAME

6       libdskrc - Custom format definitions for LibDSK programs
7

DESCRIPTION

9       The libdskrc file contains definitions of disk geometries, which can be
10       used by the LibDsk utilities dsktrans(1) , dskid(1) and dskform(1)
11       The file consists of one or more sections,  each  describing  one  disk
12       layout.  Each  section  begins with the format name in square brackets,
13       and continues until the next section begins. Within  each  section  are
14       one or more entries of the form
15
16       variable = value
17
18       Anything  after  a  semicolon or hash character is treated as a comment
19       and ignored. Blank lines are also ignored.
20

PARAMETERS

22       For each geometry, the entries listed below can be present. If not  all
23       the  values  are  present,  LibDsk  will  use  default  values from its
24       "pcw180" format (40 tracks, 9 sectors, single-sided, MFM).
25
26       description = DESC
27              The description of the format as shown by (for example)  dskform
28              --help.
29
30       sides = TREATMENT
31              How  a  double-sided  disk  is  handled.  This can either be alt
32              (sides alternate -- used by most PC-hosted  operating  systems),
33              outback (use side 0 tracks 0-79, then side 1 tracks 79-0 -- used
34              by 144FEAT CP/M disks), or outout (use side 0 tracks 0-79,  then
35              side  1  tracks 0-79 -- used by some Acorn formats). If the disk
36              is single-sided, this parameter can be omitted.
37
38       cylinders = COUNT
39              Sets the number of cylinders (usually 40 or 80).
40
41       heads = COUNT
42              Sets the number of heads (usually 1 or 2 for single- or  double-
43              sided).
44
45       sectors = COUNT
46              Sets the number of sectors per track.
47
48       secbase = NUMBER
49              Sets  the  first sector number on a track. Usually 1; some Acorn
50              formats use 0.
51
52       secsize = COUNT
53              Sets the size of a sector in bytes. This should be a power of 2.
54
55       datarate = VALUE
56              Sets the rate at which the disk should be accessed. This is  one
57              of  HD  (1.4Mb or 1.2Mb), DD (360k or 720k disc in 1.2Mb drive),
58              SD (360k or 720k disc in 1.4Mb, 720k or 360k drive), ED (2.8Mb).
59
60       rwgap = VALUE
61              Set the read/write gap.
62
63       fmtgap = VALUE
64              Set the format gap.
65
66       fm = Y or N
67              Set the recording mode.  Y for FM, N for MFM.
68
69       multitrack = Y or N
70              Set multitrack mode; this only affects attempts to  read  normal
71              data  from tracks containing deleted data (or vice versa). Y for
72              yes, N for no.
73
74       skipdeleted = Y or N
75              Skip deleted data when searching for non-deleted data  (or  vice
76              versa).  Y for yes, N for no.

FILES

78       $HOME/.libdskrc
79              User-specified format list.
80
81       /usr/local/share/LibDsk/libdskrc
82              System-wide format list.

SEE ALSO

84       dsktrans(1) , dskform(1) , dskid(1)

AUTHOR

86       John Elliott <seasip.webmaster@gmail.com>.
87
88
89
90Version 1.2.1                   20 January 2006                    libdskrc(5)
Impressum