libdskrc man page

libdskrc — Custom format definitions for LibDSK programs

Description

The libdskrc file contains definitions of disk  geometries, which can be used by the LibDsk utilities dsktrans(1) , dskid(1) and dskform(1)

The file consists of one or more sections, each describing one disk layout. Each section begins with the format name in square brackets, and  continues until the next section begins. Within each section are one or more  entries of the form

variable = value

Anything after a semicolon or hash   character is treated as a comment and ignored. Blank lines are  also ignored.

Parameters

For each geometry, the entries listed below can be present. If not  all the values are present, LibDsk will use default values from its "pcw180" format (40 tracks, 9 sectors, single-sided, MFM).

description = DESC

The description of the format as shown by (for example) dskform --help.

sides = TREATMENT

How a double-sided disk is handled. This can either be alt (sides alternate -- used by most PC-hosted operating systems), outback (use side 0 tracks 0-79, then side 1 tracks 79-0 -- used by 144FEAT  CP/M disks), or outout (use side 0 tracks 0-79, then side 1 tracks 0-79 -- used by some Acorn  formats). If the disk is single-sided, this parameter can be omitted.

cylinders = COUNT

Sets the number of cylinders (usually 40 or 80).

heads = COUNT

Sets the number of heads (usually 1 or 2 for single- or double-sided).

sectors = COUNT

Sets the number of sectors per track.

secbase = NUMBER

Sets the first sector number on a track. Usually 1; some Acorn formats use 0.

secsize = COUNT

Sets the size of a sector in bytes. This should be a power of 2.

datarate = VALUE

Sets the rate at which the disk should be accessed. This is one of HD (1.4Mb or 1.2Mb),  DD (360k or 720k disc in 1.2Mb drive), SD (360k or 720k disc in 1.4Mb, 720k or 360k drive), ED (2.8Mb).

rwgap = VALUE

Set the read/write gap.

fmtgap = VALUE

Set the format gap.

fm = Y or N

Set the recording mode. Y for FM, N for MFM.

multitrack = Y or N

Set multitrack mode; this only affects attempts to read normal data from tracks containing deleted data (or vice versa). Y for yes, N for  no.

skipdeleted = Y or N

Skip deleted data when searching for non-deleted data (or vice versa). Y for yes, N for no.

Files

$HOME/.libdskrc

User-specified format list.

/usr/local/share/LibDsk/libdskrc

System-wide format list.

See Also

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

Author

John Elliott <jce@seasip.demon.co.uk>.

Info

20 January 2006 Version 1.2.1 Emulators