| 1 |
22 |
wfjm |
.\" -*- nroff -*-
|
| 2 |
|
|
.\" $Id: create_disk.1 550 2014-02-03 08:16:57Z mueller $
|
| 3 |
|
|
.\"
|
| 4 |
|
|
.\" Copyright 2013- by Walter F.J. Mueller
|
| 5 |
|
|
.\"
|
| 6 |
|
|
.\" ------------------------------------------------------------------
|
| 7 |
|
|
.
|
| 8 |
|
|
.TH CREATE_DISK 1 2013-05-20 "Retro Project" "Retro Project Manual"
|
| 9 |
|
|
.\" ------------------------------------------------------------------
|
| 10 |
|
|
.SH NAME
|
| 11 |
|
|
create_disk \- create disk container file for ti_w11
|
| 12 |
|
|
.\" ------------------------------------------------------------------
|
| 13 |
|
|
.SH SYNOPSIS
|
| 14 |
|
|
.
|
| 15 |
|
|
.SY create_disk
|
| 16 |
|
|
.BI \-\-typ "\fR=\fPtyp"
|
| 17 |
|
|
.OP \-\-ini=\fIpat\fP
|
| 18 |
|
|
.OP \-\-bad
|
| 19 |
|
|
.OP \-\-boot
|
| 20 |
|
|
.I FILE
|
| 21 |
|
|
.
|
| 22 |
|
|
.SY create_disk
|
| 23 |
|
|
.B \-\-help
|
| 24 |
|
|
.YS
|
| 25 |
|
|
.
|
| 26 |
|
|
.\" ------------------------------------------------------------------
|
| 27 |
|
|
.SH DESCRIPTION
|
| 28 |
|
|
Creates a disk container file \fIFILE\fP with the proper size for a disk of
|
| 29 |
|
|
type \fItyp\fP.
|
| 30 |
|
|
.
|
| 31 |
|
|
.\" ------------------------------------------------------------------
|
| 32 |
|
|
.SH OPTIONS
|
| 33 |
|
|
.
|
| 34 |
|
|
.\" ----------------------------------------------
|
| 35 |
|
|
.IP \fB\-\-typ=\fItyp\fR
|
| 36 |
|
|
determines disk type, must be specified.
|
| 37 |
|
|
The list of supported disk types can be obtained with the
|
| 38 |
|
|
.B \-\-help
|
| 39 |
|
|
option.
|
| 40 |
|
|
.
|
| 41 |
|
|
.\" ----------------------------------------------
|
| 42 |
|
|
.IP \fB\-\-ini=\fIpat\fR
|
| 43 |
|
|
determines whether the container file will be initialized with specific
|
| 44 |
|
|
data pattern. Note that the \fB\-\-bad\fP and \fB\-\-boot\fP options will
|
| 45 |
|
|
overwrite the last track or the first sector(s) respectively.
|
| 46 |
|
|
Allowed values for \fIpat\fP are
|
| 47 |
|
|
.RS
|
| 48 |
|
|
.IP \fBzero\fP
|
| 49 |
|
|
creates a disk with all sectors zero'ed. This is the default when no
|
| 50 |
|
|
\fB\-\-ini\fP option is given.
|
| 51 |
|
|
.IP \fBones\fP
|
| 52 |
|
|
creates a disk with all data bytes set to 0xff.
|
| 53 |
|
|
.IP \fBdead\fP
|
| 54 |
|
|
creates a disk with an alternating 0xdead 0xbeaf pattern. Can be helpful
|
| 55 |
|
|
to diagnose whether an operating system access previously in initialized
|
| 56 |
|
|
parts of a disk.
|
| 57 |
|
|
.IP \fBtest\fP
|
| 58 |
|
|
creates a disk with a unique test pattern in each sector. The whole disk
|
| 59 |
|
|
is initialized with groups of 8 16bit words (in PDP-11 little endian) with
|
| 60 |
|
|
|
| 61 |
|
|
.RS
|
| 62 |
|
|
.RS 3
|
| 63 |
|
|
.PD 0
|
| 64 |
|
|
.IP 0: 4
|
| 65 |
|
|
absolute disk byte address, lower word
|
| 66 |
|
|
.IP 1: 4
|
| 67 |
|
|
absolute disk byte address, upper word
|
| 68 |
|
|
.IP 2: 4
|
| 69 |
|
|
current cyclinder number (0 based)
|
| 70 |
|
|
.IP 3: 4
|
| 71 |
|
|
current track/head number (0 based)
|
| 72 |
|
|
.IP 4: 4
|
| 73 |
|
|
current sector number (0 based)
|
| 74 |
|
|
.IP 5: 4
|
| 75 |
|
|
number of cyclinders for disk type
|
| 76 |
|
|
.IP 6: 4
|
| 77 |
|
|
number of tracks/heads for disk type
|
| 78 |
|
|
.IP 7: 4
|
| 79 |
|
|
number of sectors for disk type
|
| 80 |
|
|
.RE
|
| 81 |
|
|
.PD
|
| 82 |
|
|
.PP
|
| 83 |
|
|
A \fBhexdump\fP(1) of a RP06 disk image initialized with
|
| 84 |
|
|
\fB\-\-ini\fP=\fItest\fP
|
| 85 |
|
|
will look like
|
| 86 |
|
|
|
| 87 |
|
|
.EX
|
| 88 |
|
|
0000000 0000 0000 0000 0000 0000 032f 0013 0016
|
| 89 |
|
|
0000010 0010 0000 0000 0000 0000 032f 0013 0016
|
| 90 |
|
|
...
|
| 91 |
|
|
00001f0 01f0 0000 0000 0000 0000 032f 0013 0016
|
| 92 |
|
|
0000200 0200 0000 0000 0000 0001 032f 0013 0016
|
| 93 |
|
|
...
|
| 94 |
|
|
a657be0 7be0 0a65 032e 0012 0015 032f 0013 0016
|
| 95 |
|
|
a657bf0 7bf0 0a65 032e 0012 0015 032f 0013 0016
|
| 96 |
|
|
.EE
|
| 97 |
|
|
.
|
| 98 |
|
|
.RE
|
| 99 |
|
|
.RE
|
| 100 |
|
|
.
|
| 101 |
|
|
.\" ----------------------------------------------
|
| 102 |
|
|
.IP \fB\-\-bad\fP
|
| 103 |
|
|
creates a DEC standard 044 compliant bad block table on the last track
|
| 104 |
|
|
of the disk container file.
|
| 105 |
|
|
.
|
| 106 |
|
|
.\" ----------------------------------------------
|
| 107 |
|
|
.IP \fB\-\-boot\fP
|
| 108 |
|
|
creates a PDP-11 dummy boot block. When such a disk is attached and booted
|
| 109 |
|
|
with \fBti_w11\fP(1) or a simh pdp11 a message like
|
| 110 |
|
|
|
| 111 |
|
|
.EX
|
| 112 |
|
|
++======================================++
|
| 113 |
|
|
|| This is not a hardware bootable disk ||
|
| 114 |
|
|
++======================================++
|
| 115 |
|
|
|
| 116 |
|
|
Disk image created with 'create_disk --typ=RK05':
|
| 117 |
|
|
number of cylinders: 203
|
| 118 |
|
|
tracks per cylinder: 2
|
| 119 |
|
|
sectors per track: 12
|
| 120 |
|
|
block size: 512
|
| 121 |
|
|
total number of sectors: 4872
|
| 122 |
|
|
capacity in kByte: 2436
|
| 123 |
|
|
|
| 124 |
|
|
CPU WILL HALT
|
| 125 |
|
|
.EE
|
| 126 |
|
|
|
| 127 |
|
|
will be printed on the system console and the CPU HALTed.
|
| 128 |
|
|
.
|
| 129 |
|
|
.\" ----------------------------------------------
|
| 130 |
|
|
.IP \fB\-\-help\fP
|
| 131 |
|
|
print full help, with list \fB\-\-typ\fP and \fB\-\-ini\fP options.
|
| 132 |
|
|
.
|
| 133 |
|
|
.\" ------------------------------------------------------------------
|
| 134 |
|
|
.SH EXIT STATUS
|
| 135 |
|
|
If the file
|
| 136 |
|
|
.I FILE
|
| 137 |
|
|
can not be created an exit status 1 is returned.
|
| 138 |
|
|
|
| 139 |
|
|
.\" ------------------------------------------------------------------
|
| 140 |
|
|
.SH EXAMPLES
|
| 141 |
|
|
.IP "\fBcreate_disk -typ=rk05 rk05.dsk\fR" 4
|
| 142 |
|
|
This will create a zero'ed disk contained sized for a RK05 disk. In most
|
| 143 |
|
|
cases it is sufficient to create such plain zero'ed disk images.
|
| 144 |
|
|
.
|
| 145 |
|
|
.IP "\fBcreate_disk -typ=rl02 -bad rl02.dsk\fR"
|
| 146 |
|
|
Creates a RL02 sized disk with a 'factory bad block table'. When using
|
| 147 |
|
|
RLxx, RPxx, or RMxx type disks, especially in conjunction with DEC
|
| 148 |
|
|
operating systems, it is advisable to create disks with \fB\-\-bad\fP.
|
| 149 |
|
|
.
|
| 150 |
|
|
.IP "\fBcreate_disk -typ=rk05 -ini=test rk05_test.dsk\fR"
|
| 151 |
|
|
Creates a RK05 sized disk with test pattern.
|
| 152 |
|
|
.
|
| 153 |
|
|
.\" ------------------------------------------------------------------
|
| 154 |
|
|
.SH "SEE ALSO"
|
| 155 |
|
|
.BR ti_w11 (1)
|
| 156 |
|
|
|
| 157 |
|
|
.\" ------------------------------------------------------------------
|
| 158 |
|
|
.SH AUTHOR
|
| 159 |
|
|
Walter F.J. Mueller
|
