FEX-Emu/linux
1
0
Fork 0
mirror of https://github.com/FEX-Emu/linux.git synced 2025-02-03 09:34:42 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: m68k: convert docs to ReST and rename to *.rst

Browse Source 
Convert the m68k kernel-options.txt file to ReST.

The conversion is trivial, as the document is already on a format
close enough to ReST. Just some small adjustments were needed in
order to make it both good for being parsed while keeping it on
a good txt shape.

At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
This commit is contained in:
Mauro Carvalho Chehab 2019-04-14 08:27:15 -03:00
parent 6f2846cc2e
commit 23e0242287
3 changed files with 191 additions and 147 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Documentation/admin-guide/kernel-parameters.rst
View File

@ -118,7 +118,7 @@ parameter is applicable::
LOOP Loopback device support is enabled. LOOP Loopback device support is enabled.
M68k M68k architecture is enabled. M68k M68k architecture is enabled.
These options have more detailed description inside of These options have more detailed description inside of
Documentation/m68k/kernel-options.txt. Documentation/m68k/kernel-options.rst.
MDA MDA console support is enabled. MDA MDA console support is enabled.
MIPS MIPS architecture is enabled. MIPS MIPS architecture is enabled.
MOUSE Appropriate mouse support is enabled. MOUSE Appropriate mouse support is enabled.

17
Documentation/m68k/index.rst Normal file
View File

@ -0,0 +1,17 @@
:orphan:
=================
m68k Architecture
=================
.. toctree::
:maxdepth: 2
kernel-options
.. only:: subproject and html
Indices
=======
* :ref:`genindex`

299
Documentation/m68k/kernel-options.txt → Documentation/m68k/kernel-options.rst
View File

@ -1,22 +1,24 @@
===================================
Command Line Options for Linux/m68k
Command Line Options for Linux/m68k ===================================
===================================
Last Update: 2 May 1999 Last Update: 2 May 1999
Linux/m68k version: 2.2.6 Linux/m68k version: 2.2.6
Author: Roman.Hodek@informatik.uni-erlangen.de (Roman Hodek) Author: Roman.Hodek@informatik.uni-erlangen.de (Roman Hodek)
Update: jds@kom.auc.dk (Jes Sorensen) and faq@linux-m68k.org (Chris Lawrence) Update: jds@kom.auc.dk (Jes Sorensen) and faq@linux-m68k.org (Chris Lawrence)
0) Introduction 0) Introduction
=============== ===============
Often I've been asked which command line options the Linux/m68k Often I've been asked which command line options the Linux/m68k
kernel understands, or how the exact syntax for the ... option is, or kernel understands, or how the exact syntax for the ... option is, or
... about the option ... . I hope, this document supplies all the ... about the option ... . I hope, this document supplies all the
answers... answers...
Note that some options might be outdated, their descriptions being Note that some options might be outdated, their descriptions being
incomplete or missing. Please update the information and send in the incomplete or missing. Please update the information and send in the
patches. patches.
@ -38,11 +40,11 @@ argument contains an '=', it is of class 2, and the definition is put
into init's environment. All other arguments are passed to init as into init's environment. All other arguments are passed to init as
command line options. command line options.
This document describes the valid kernel options for Linux/m68k in This document describes the valid kernel options for Linux/m68k in
the version mentioned at the start of this file. Later revisions may the version mentioned at the start of this file. Later revisions may
add new such options, and some may be missing in older versions. add new such options, and some may be missing in older versions.
In general, the value (the part after the '=') of an option is a In general, the value (the part after the '=') of an option is a
list of values separated by commas. The interpretation of these values list of values separated by commas. The interpretation of these values
is up to the driver that "owns" the option. This association of is up to the driver that "owns" the option. This association of
options with drivers is also the reason that some are further options with drivers is also the reason that some are further
@ -55,21 +57,21 @@ subdivided.
2.1) root= 2.1) root=
---------- ----------
Syntax: root=/dev/<device> :Syntax: root=/dev/<device>
or: root=<hex_number> :or: root=<hex_number>
This tells the kernel which device it should mount as the root This tells the kernel which device it should mount as the root
filesystem. The device must be a block device with a valid filesystem filesystem. The device must be a block device with a valid filesystem
on it. on it.
The first syntax gives the device by name. These names are converted The first syntax gives the device by name. These names are converted
into a major/minor number internally in the kernel in an unusual way. into a major/minor number internally in the kernel in an unusual way.
Normally, this "conversion" is done by the device files in /dev, but Normally, this "conversion" is done by the device files in /dev, but
this isn't possible here, because the root filesystem (with /dev) this isn't possible here, because the root filesystem (with /dev)
isn't mounted yet... So the kernel parses the name itself, with some isn't mounted yet... So the kernel parses the name itself, with some
hardcoded name to number mappings. The name must always be a hardcoded name to number mappings. The name must always be a
combination of two or three letters, followed by a decimal number. combination of two or three letters, followed by a decimal number.
Valid names are: Valid names are::
/dev/ram: -> 0x0100 (initial ramdisk) /dev/ram: -> 0x0100 (initial ramdisk)
/dev/hda: -> 0x0300 (first IDE disk) /dev/hda: -> 0x0300 (first IDE disk)
@ -81,7 +83,7 @@ Valid names are:
/dev/sde: -> 0x0840 (fifth SCSI disk) /dev/sde: -> 0x0840 (fifth SCSI disk)
/dev/fd : -> 0x0200 (floppy disk) /dev/fd : -> 0x0200 (floppy disk)
The name must be followed by a decimal number, that stands for the The name must be followed by a decimal number, that stands for the
partition number. Internally, the value of the number is just partition number. Internally, the value of the number is just
added to the device number mentioned in the table above. The added to the device number mentioned in the table above. The
exceptions are /dev/ram and /dev/fd, where /dev/ram refers to an exceptions are /dev/ram and /dev/fd, where /dev/ram refers to an
@ -100,7 +102,7 @@ the kernel command line.
[Strange and maybe uninteresting stuff ON] [Strange and maybe uninteresting stuff ON]
This unusual translation of device names has some strange This unusual translation of device names has some strange
consequences: If, for example, you have a symbolic link from /dev/fd consequences: If, for example, you have a symbolic link from /dev/fd
to /dev/fd0D720 as an abbreviation for floppy driver #0 in DD format, to /dev/fd0D720 as an abbreviation for floppy driver #0 in DD format,
you cannot use this name for specifying the root device, because the you cannot use this name for specifying the root device, because the
@ -118,7 +120,7 @@ knowledge that each disk uses 16 minors, and write "root=/dev/sde17"
[Strange and maybe uninteresting stuff OFF] [Strange and maybe uninteresting stuff OFF]
If the device containing your root partition isn't in the table If the device containing your root partition isn't in the table
above, you can also specify it by major and minor numbers. These are above, you can also specify it by major and minor numbers. These are
written in hex, with no prefix and no separator between. E.g., if you written in hex, with no prefix and no separator between. E.g., if you
have a CD with contents appropriate as a root filesystem in the first have a CD with contents appropriate as a root filesystem in the first
@ -136,6 +138,7 @@ known partition UUID as the starting point. For example,
if partition 5 of the device has the UUID of if partition 5 of the device has the UUID of
00112233-4455-6677-8899-AABBCCDDEEFF then partition 3 may be found as 00112233-4455-6677-8899-AABBCCDDEEFF then partition 3 may be found as
follows: follows:
PARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF/PARTNROFF=-2 PARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF/PARTNROFF=-2
Authoritative information can be found in Authoritative information can be found in
@ -145,8 +148,8 @@ Authoritative information can be found in
2.2) ro, rw 2.2) ro, rw
----------- -----------
Syntax: ro :Syntax: ro
or: rw :or: rw
These two options tell the kernel whether it should mount the root These two options tell the kernel whether it should mount the root
filesystem read-only or read-write. The default is read-only, except filesystem read-only or read-write. The default is read-only, except
@ -156,7 +159,7 @@ for ramdisks, which default to read-write.
2.3) debug 2.3) debug
---------- ----------
Syntax: debug :Syntax: debug
This raises the kernel log level to 10 (the default is 7). This is the This raises the kernel log level to 10 (the default is 7). This is the
same level as set by the "dmesg" command, just that the maximum level same level as set by the "dmesg" command, just that the maximum level
@ -166,7 +169,7 @@ selectable by dmesg is 8.
2.4) debug= 2.4) debug=
----------- -----------
Syntax: debug=<device> :Syntax: debug=<device>
This option causes certain kernel messages be printed to the selected This option causes certain kernel messages be printed to the selected
debugging device. This can aid debugging the kernel, since the debugging device. This can aid debugging the kernel, since the
@ -175,7 +178,7 @@ devices are possible depends on the machine type. There are no checks
for the validity of the device name. If the device isn't implemented, for the validity of the device name. If the device isn't implemented,
nothing happens. nothing happens.
Messages logged this way are in general stack dumps after kernel Messages logged this way are in general stack dumps after kernel
memory faults or bad kernel traps, and kernel panics. To be exact: all memory faults or bad kernel traps, and kernel panics. To be exact: all
messages of level 0 (panic messages) and all messages printed while messages of level 0 (panic messages) and all messages printed while
the log level is 8 or more (their level doesn't matter). Before stack the log level is 8 or more (their level doesn't matter). Before stack
@ -185,19 +188,27 @@ at least 8 can also be set by the "debug" command line option (see
Devices possible for Amiga: Devices possible for Amiga:
- "ser": built-in serial port; parameters: 9600bps, 8N1 - "ser":
- "mem": Save the messages to a reserved area in chip mem. After built-in serial port; parameters: 9600bps, 8N1
- "mem":
Save the messages to a reserved area in chip mem. After
rebooting, they can be read under AmigaOS with the tool rebooting, they can be read under AmigaOS with the tool
'dmesg'. 'dmesg'.
Devices possible for Atari: Devices possible for Atari:
- "ser1": ST-MFP serial port ("Modem1"); parameters: 9600bps, 8N1 - "ser1":
- "ser2": SCC channel B serial port ("Modem2"); parameters: 9600bps, 8N1 ST-MFP serial port ("Modem1"); parameters: 9600bps, 8N1
- "ser" : default serial port - "ser2":
SCC channel B serial port ("Modem2"); parameters: 9600bps, 8N1
- "ser" :
default serial port
This is "ser2" for a Falcon, and "ser1" for any other machine This is "ser2" for a Falcon, and "ser1" for any other machine
- "midi": The MIDI port; parameters: 31250bps, 8N1 - "midi":
- "par" : parallel port The MIDI port; parameters: 31250bps, 8N1
- "par" :
parallel port
The printing routine for this implements a timeout for the The printing routine for this implements a timeout for the
case there's no printer connected (else the kernel would case there's no printer connected (else the kernel would
lock up). The timeout is not exact, but usually a few lock up). The timeout is not exact, but usually a few
@ -205,26 +216,29 @@ Devices possible for Atari:
2.6) ramdisk_size= 2.6) ramdisk_size=
------------- ------------------
Syntax: ramdisk_size=<size> :Syntax: ramdisk_size=<size>
This option instructs the kernel to set up a ramdisk of the given This option instructs the kernel to set up a ramdisk of the given
size in KBytes. Do not use this option if the ramdisk contents are size in KBytes. Do not use this option if the ramdisk contents are
passed by bootstrap! In this case, the size is selected automatically passed by bootstrap! In this case, the size is selected automatically
and should not be overwritten. and should not be overwritten.
The only application is for root filesystems on floppy disks, that The only application is for root filesystems on floppy disks, that
should be loaded into memory. To do that, select the corresponding should be loaded into memory. To do that, select the corresponding
size of the disk as ramdisk size, and set the root device to the disk size of the disk as ramdisk size, and set the root device to the disk
drive (with "root="). drive (with "root=").
2.7) swap= 2.7) swap=
I can't find any sign of this option in 2.2.6.
2.8) buff= 2.8) buff=
----------- -----------
I can't find any sign of these options in 2.2.6. I can't find any sign of this option in 2.2.6.
3) General Device Options (Amiga and Atari) 3) General Device Options (Amiga and Atari)
@ -233,13 +247,13 @@ drive (with "root=").
3.1) ether= 3.1) ether=
----------- -----------
Syntax: ether=[<irq>[,<base_addr>[,<mem_start>[,<mem_end>]]]],<dev-name> :Syntax: ether=[<irq>[,<base_addr>[,<mem_start>[,<mem_end>]]]],<dev-name>
<dev-name> is the name of a net driver, as specified in <dev-name> is the name of a net driver, as specified in
drivers/net/Space.c in the Linux source. Most prominent are eth0, ... drivers/net/Space.c in the Linux source. Most prominent are eth0, ...
eth3, sl0, ... sl3, ppp0, ..., ppp3, dummy, and lo. eth3, sl0, ... sl3, ppp0, ..., ppp3, dummy, and lo.
The non-ethernet drivers (sl, ppp, dummy, lo) obviously ignore the The non-ethernet drivers (sl, ppp, dummy, lo) obviously ignore the
settings by this options. Also, the existing ethernet drivers for settings by this options. Also, the existing ethernet drivers for
Linux/m68k (ariadne, a2065, hydra) don't use them because Zorro boards Linux/m68k (ariadne, a2065, hydra) don't use them because Zorro boards
are really Plug-'n-Play, so the "ether=" option is useless altogether are really Plug-'n-Play, so the "ether=" option is useless altogether
@ -249,9 +263,9 @@ for Linux/m68k.
3.2) hd= 3.2) hd=
-------- --------
Syntax: hd=<cylinders>,<heads>,<sectors> :Syntax: hd=<cylinders>,<heads>,<sectors>
This option sets the disk geometry of an IDE disk. The first hd= This option sets the disk geometry of an IDE disk. The first hd=
option is for the first IDE disk, the second for the second one. option is for the first IDE disk, the second for the second one.
(I.e., you can give this option twice.) In most cases, you won't have (I.e., you can give this option twice.) In most cases, you won't have
to use this option, since the kernel can obtain the geometry data to use this option, since the kernel can obtain the geometry data
@ -262,9 +276,9 @@ disks.
3.3) max_scsi_luns= 3.3) max_scsi_luns=
------------------- -------------------
Syntax: max_scsi_luns=<n> :Syntax: max_scsi_luns=<n>
Sets the maximum number of LUNs (logical units) of SCSI devices to Sets the maximum number of LUNs (logical units) of SCSI devices to
be scanned. Valid values for <n> are between 1 and 8. Default is 8 if be scanned. Valid values for <n> are between 1 and 8. Default is 8 if
"Probe all LUNs on each SCSI device" was selected during the kernel "Probe all LUNs on each SCSI device" was selected during the kernel
configuration, else 1. configuration, else 1.
@ -273,9 +287,9 @@ configuration, else 1.
3.4) st= 3.4) st=
-------- --------
Syntax: st=<buffer_size>,[<write_thres>,[<max_buffers>]] :Syntax: st=<buffer_size>,[<write_thres>,[<max_buffers>]]
Sets several parameters of the SCSI tape driver. <buffer_size> is Sets several parameters of the SCSI tape driver. <buffer_size> is
the number of 512-byte buffers reserved for tape operations for each the number of 512-byte buffers reserved for tape operations for each
device. <write_thres> sets the number of blocks which must be filled device. <write_thres> sets the number of blocks which must be filled
to start an actual write operation to the tape. Maximum value is the to start an actual write operation to the tape. Maximum value is the
@ -286,9 +300,9 @@ buffers allocated for all tape devices.
3.5) dmasound= 3.5) dmasound=
-------------- --------------
Syntax: dmasound=[<buffers>,<buffer-size>[,<catch-radius>]] :Syntax: dmasound=[<buffers>,<buffer-size>[,<catch-radius>]]
This option controls some configurations of the Linux/m68k DMA sound This option controls some configurations of the Linux/m68k DMA sound
driver (Amiga and Atari): <buffers> is the number of buffers you want driver (Amiga and Atari): <buffers> is the number of buffers you want
to use (minimum 4, default 4), <buffer-size> is the size of each to use (minimum 4, default 4), <buffer-size> is the size of each
buffer in kilobytes (minimum 4, default 32) and <catch-radius> says buffer in kilobytes (minimum 4, default 32) and <catch-radius> says
@ -305,20 +319,22 @@ don't need to expand the sound.
4.1) video= 4.1) video=
----------- -----------
Syntax: video=<fbname>:<sub-options...> :Syntax: video=<fbname>:<sub-options...>
The <fbname> parameter specifies the name of the frame buffer, The <fbname> parameter specifies the name of the frame buffer,
eg. most atari users will want to specify `atafb' here. The eg. most atari users will want to specify `atafb` here. The
<sub-options> is a comma-separated list of the sub-options listed <sub-options> is a comma-separated list of the sub-options listed
below. below.
NB: Please notice that this option was renamed from `atavideo' to NB:
`video' during the development of the 1.3.x kernels, thus you Please notice that this option was renamed from `atavideo` to
`video` during the development of the 1.3.x kernels, thus you
might need to update your boot-scripts if upgrading to 2.x from might need to update your boot-scripts if upgrading to 2.x from
an 1.2.x kernel. an 1.2.x kernel.
NBB: The behavior of video= was changed in 2.1.57 so the recommended NBB:
option is to specify the name of the frame buffer. The behavior of video= was changed in 2.1.57 so the recommended
option is to specify the name of the frame buffer.
4.1.1) Video Mode 4.1.1) Video Mode
----------------- -----------------
@ -341,11 +357,11 @@ mode, if the hardware allows. Currently defined names are:
- falh2 : 896x608x1, Falcon only - falh2 : 896x608x1, Falcon only
- falh16 : 896x608x4, Falcon only - falh16 : 896x608x4, Falcon only
If no video mode is given on the command line, the kernel tries the If no video mode is given on the command line, the kernel tries the
modes names "default<n>" in turn, until one is possible with the modes names "default<n>" in turn, until one is possible with the
hardware in use. hardware in use.
A video mode setting doesn't make sense, if the external driver is A video mode setting doesn't make sense, if the external driver is
activated by a "external:" sub-option. activated by a "external:" sub-option.
4.1.2) inverse 4.1.2) inverse
@ -358,17 +374,17 @@ option, you can make the background white.
4.1.3) font 4.1.3) font
----------- -----------
Syntax: font:<fontname> :Syntax: font:<fontname>
Specify the font to use in text modes. Currently you can choose only Specify the font to use in text modes. Currently you can choose only
between `VGA8x8', `VGA8x16' and `PEARL8x8'. `VGA8x8' is default, if the between `VGA8x8`, `VGA8x16` and `PEARL8x8`. `VGA8x8` is default, if the
vertical size of the display is less than 400 pixel rows. Otherwise, the vertical size of the display is less than 400 pixel rows. Otherwise, the
`VGA8x16' font is the default. `VGA8x16` font is the default.
4.1.4) hwscroll_ 4.1.4) `hwscroll_`
---------------- ------------------
Syntax: hwscroll_<n> :Syntax: `hwscroll_<n>`
The number of additional lines of video memory to reserve for The number of additional lines of video memory to reserve for
speeding up the scrolling ("hardware scrolling"). Hardware scrolling speeding up the scrolling ("hardware scrolling"). Hardware scrolling
@ -378,7 +394,7 @@ possible with plain STs and graphics cards (The former because the
base address must be on a 256 byte boundary there, the latter because base address must be on a 256 byte boundary there, the latter because
the kernel doesn't know how to set the base address at all.) the kernel doesn't know how to set the base address at all.)
By default, <n> is set to the number of visible text lines on the By default, <n> is set to the number of visible text lines on the
display. Thus, the amount of video memory is doubled, compared to no display. Thus, the amount of video memory is doubled, compared to no
hardware scrolling. You can turn off the hardware scrolling altogether hardware scrolling. You can turn off the hardware scrolling altogether
by setting <n> to 0. by setting <n> to 0.
@ -386,31 +402,31 @@ by setting <n> to 0.
4.1.5) internal: 4.1.5) internal:
---------------- ----------------
Syntax: internal:<xres>;<yres>[;<xres_max>;<yres_max>;<offset>] :Syntax: internal:<xres>;<yres>[;<xres_max>;<yres_max>;<offset>]
This option specifies the capabilities of some extended internal video This option specifies the capabilities of some extended internal video
hardware, like e.g. OverScan. <xres> and <yres> give the (extended) hardware, like e.g. OverScan. <xres> and <yres> give the (extended)
dimensions of the screen. dimensions of the screen.
If your OverScan needs a black border, you have to write the last If your OverScan needs a black border, you have to write the last
three arguments of the "internal:". <xres_max> is the maximum line three arguments of the "internal:". <xres_max> is the maximum line
length the hardware allows, <yres_max> the maximum number of lines. length the hardware allows, <yres_max> the maximum number of lines.
<offset> is the offset of the visible part of the screen memory to its <offset> is the offset of the visible part of the screen memory to its
physical start, in bytes. physical start, in bytes.
Often, extended interval video hardware has to be activated somehow. Often, extended interval video hardware has to be activated somehow.
For this, see the "sw_*" options below. For this, see the "sw_*" options below.
4.1.6) external: 4.1.6) external:
---------------- ----------------
Syntax: :Syntax:
external:<xres>;<yres>;<depth>;<org>;<scrmem>[;<scrlen>[;<vgabase>\ external:<xres>;<yres>;<depth>;<org>;<scrmem>[;<scrlen>[;<vgabase>
[;<colw>[;<coltype>[;<xres_virtual>]]]]] [;<colw>[;<coltype>[;<xres_virtual>]]]]]
[I had to break this line...] .. I had to break this line...
This is probably the most complicated parameter... It specifies that This is probably the most complicated parameter... It specifies that
you have some external video hardware (a graphics board), and how to you have some external video hardware (a graphics board), and how to
use it under Linux/m68k. The kernel cannot know more about the hardware use it under Linux/m68k. The kernel cannot know more about the hardware
than you tell it here! The kernel also is unable to set or change any than you tell it here! The kernel also is unable to set or change any
@ -418,38 +434,44 @@ video modes, since it doesn't know about any board internal. So, you
have to switch to that video mode before you start Linux, and cannot have to switch to that video mode before you start Linux, and cannot
switch to another mode once Linux has started. switch to another mode once Linux has started.
The first 3 parameters of this sub-option should be obvious: <xres>, The first 3 parameters of this sub-option should be obvious: <xres>,
<yres> and <depth> give the dimensions of the screen and the number of <yres> and <depth> give the dimensions of the screen and the number of
planes (depth). The depth is the logarithm to base 2 of the number planes (depth). The depth is the logarithm to base 2 of the number
of colors possible. (Or, the other way round: The number of colors is of colors possible. (Or, the other way round: The number of colors is
2^depth). 2^depth).
You have to tell the kernel furthermore how the video memory is You have to tell the kernel furthermore how the video memory is
organized. This is done by a letter as <org> parameter: organized. This is done by a letter as <org> parameter:
'n': "normal planes", i.e. one whole plane after another 'n':
'i': "interleaved planes", i.e. 16 bit of the first plane, than 16 bit "normal planes", i.e. one whole plane after another
'i':
"interleaved planes", i.e. 16 bit of the first plane, than 16 bit
of the next, and so on... This mode is used only with the of the next, and so on... This mode is used only with the
built-in Atari video modes, I think there is no card that built-in Atari video modes, I think there is no card that
supports this mode. supports this mode.
'p': "packed pixels", i.e. <depth> consecutive bits stand for all 'p':
"packed pixels", i.e. <depth> consecutive bits stand for all
planes of one pixel; this is the most common mode for 8 planes planes of one pixel; this is the most common mode for 8 planes
(256 colors) on graphic cards (256 colors) on graphic cards
't': "true color" (more or less packed pixels, but without a color 't':
"true color" (more or less packed pixels, but without a color
lookup table); usually depth is 24 lookup table); usually depth is 24
For monochrome modes (i.e., <depth> is 1), the <org> letter has a For monochrome modes (i.e., <depth> is 1), the <org> letter has a
different meaning: different meaning:
'n': normal colors, i.e. 0=white, 1=black 'n':
'i': inverted colors, i.e. 0=black, 1=white normal colors, i.e. 0=white, 1=black
'i':
inverted colors, i.e. 0=black, 1=white
The next important information about the video hardware is the base The next important information about the video hardware is the base
address of the video memory. That is given in the <scrmem> parameter, address of the video memory. That is given in the <scrmem> parameter,
as a hexadecimal number with a "0x" prefix. You have to find out this as a hexadecimal number with a "0x" prefix. You have to find out this
address in the documentation of your hardware. address in the documentation of your hardware.
The next parameter, <scrlen>, tells the kernel about the size of the The next parameter, <scrlen>, tells the kernel about the size of the
video memory. If it's missing, the size is calculated from <xres>, video memory. If it's missing, the size is calculated from <xres>,
<yres>, and <depth>. For now, it is not useful to write a value here. <yres>, and <depth>. For now, it is not useful to write a value here.
It would be used only for hardware scrolling (which isn't possible It would be used only for hardware scrolling (which isn't possible
@ -460,7 +482,7 @@ empty, either by ending the "external:" after the video address or by
writing two consecutive semicolons, if you want to give a <vgabase> writing two consecutive semicolons, if you want to give a <vgabase>
(it is allowed to leave this parameter empty). (it is allowed to leave this parameter empty).
The <vgabase> parameter is optional. If it is not given, the kernel The <vgabase> parameter is optional. If it is not given, the kernel
cannot read or write any color registers of the video hardware, and cannot read or write any color registers of the video hardware, and
thus you have to set appropriate colors before you start Linux. But if thus you have to set appropriate colors before you start Linux. But if
your card is somehow VGA compatible, you can tell the kernel the base your card is somehow VGA compatible, you can tell the kernel the base
@ -472,17 +494,17 @@ uses the addresses vgabase+0x3c7...vgabase+0x3c9. The <vgabase>
parameter is written in hexadecimal with a "0x" prefix, just as parameter is written in hexadecimal with a "0x" prefix, just as
<scrmem>. <scrmem>.
<colw> is meaningful only if <vgabase> is specified. It tells the <colw> is meaningful only if <vgabase> is specified. It tells the
kernel how wide each of the color register is, i.e. the number of bits kernel how wide each of the color register is, i.e. the number of bits
per single color (red/green/blue). Default is 6, another quite usual per single color (red/green/blue). Default is 6, another quite usual
value is 8. value is 8.
Also <coltype> is used together with <vgabase>. It tells the kernel Also <coltype> is used together with <vgabase>. It tells the kernel
about the color register model of your gfx board. Currently, the types about the color register model of your gfx board. Currently, the types
"vga" (which is also the default) and "mv300" (SANG MV300) are "vga" (which is also the default) and "mv300" (SANG MV300) are
implemented. implemented.
Parameter <xres_virtual> is required for ProMST or ET4000 cards where Parameter <xres_virtual> is required for ProMST or ET4000 cards where
the physical linelength differs from the visible length. With ProMST, the physical linelength differs from the visible length. With ProMST,
xres_virtual must be set to 2048. For ET4000, xres_virtual depends on the xres_virtual must be set to 2048. For ET4000, xres_virtual depends on the
initialisation of the video-card. initialisation of the video-card.
@ -499,13 +521,13 @@ currently works only with the ScreenWonder!
4.1.8) monitorcap: 4.1.8) monitorcap:
------------------- -------------------
Syntax: monitorcap:<vmin>;<vmax>;<hmin>;<hmax> :Syntax: monitorcap:<vmin>;<vmax>;<hmin>;<hmax>
This describes the capabilities of a multisync monitor. Don't use it This describes the capabilities of a multisync monitor. Don't use it
with a fixed-frequency monitor! For now, only the Falcon frame buffer with a fixed-frequency monitor! For now, only the Falcon frame buffer
uses the settings of "monitorcap:". uses the settings of "monitorcap:".
<vmin> and <vmax> are the minimum and maximum, resp., vertical frequencies <vmin> and <vmax> are the minimum and maximum, resp., vertical frequencies
your monitor can work with, in Hz. <hmin> and <hmax> are the same for your monitor can work with, in Hz. <hmin> and <hmax> are the same for
the horizontal frequency, in kHz. the horizontal frequency, in kHz.
@ -520,28 +542,28 @@ If this option is given, the framebuffer device doesn't do any video
mode calculations and settings on its own. The only Atari fb device mode calculations and settings on its own. The only Atari fb device
that does this currently is the Falcon. that does this currently is the Falcon.
What you reach with this: Settings for unknown video extensions What you reach with this: Settings for unknown video extensions
aren't overridden by the driver, so you can still use the mode found aren't overridden by the driver, so you can still use the mode found
when booting, when the driver doesn't know to set this mode itself. when booting, when the driver doesn't know to set this mode itself.
But this also means, that you can't switch video modes anymore... But this also means, that you can't switch video modes anymore...
An example where you may want to use "keep" is the ScreenBlaster for An example where you may want to use "keep" is the ScreenBlaster for
the Falcon. the Falcon.
4.2) atamouse= 4.2) atamouse=
-------------- --------------
Syntax: atamouse=<x-threshold>,[<y-threshold>] :Syntax: atamouse=<x-threshold>,[<y-threshold>]
With this option, you can set the mouse movement reporting threshold. With this option, you can set the mouse movement reporting threshold.
This is the number of pixels of mouse movement that have to accumulate This is the number of pixels of mouse movement that have to accumulate
before the IKBD sends a new mouse packet to the kernel. Higher values before the IKBD sends a new mouse packet to the kernel. Higher values
reduce the mouse interrupt load and thus reduce the chance of keyboard reduce the mouse interrupt load and thus reduce the chance of keyboard
overruns. Lower values give a slightly faster mouse responses and overruns. Lower values give a slightly faster mouse responses and
slightly better mouse tracking. slightly better mouse tracking.
You can set the threshold in x and y separately, but usually this is You can set the threshold in x and y separately, but usually this is
of little practical use. If there's just one number in the option, it of little practical use. If there's just one number in the option, it
is used for both dimensions. The default value is 2 for both is used for both dimensions. The default value is 2 for both
thresholds. thresholds.
@ -550,7 +572,7 @@ thresholds.
4.3) ataflop= 4.3) ataflop=
------------- -------------
Syntax: ataflop=<drive type>[,<trackbuffering>[,<steprateA>[,<steprateB>]]] :Syntax: ataflop=<drive type>[,<trackbuffering>[,<steprateA>[,<steprateB>]]]
The drive type may be 0, 1, or 2, for DD, HD, and ED, resp. This The drive type may be 0, 1, or 2, for DD, HD, and ED, resp. This
setting affects how many buffers are reserved and which formats are setting affects how many buffers are reserved and which formats are
@ -569,9 +591,9 @@ Syntax: ataflop=<drive type>[,<trackbuffering>[,<steprateA>[,<steprateB>]]]
4.4) atascsi= 4.4) atascsi=
------------- -------------
Syntax: atascsi=<can_queue>[,<cmd_per_lun>[,<scat-gat>[,<host-id>[,<tagged>]]]] :Syntax: atascsi=<can_queue>[,<cmd_per_lun>[,<scat-gat>[,<host-id>[,<tagged>]]]]
This option sets some parameters for the Atari native SCSI driver. This option sets some parameters for the Atari native SCSI driver.
Generally, any number of arguments can be omitted from the end. And Generally, any number of arguments can be omitted from the end. And
for each of the numbers, a negative value means "use default". The for each of the numbers, a negative value means "use default". The
defaults depend on whether TT-style or Falcon-style SCSI is used. defaults depend on whether TT-style or Falcon-style SCSI is used.
@ -600,8 +622,11 @@ ignored (others aren't affected).
The <cmd_per_lun> value at a great part determines the amount of The <cmd_per_lun> value at a great part determines the amount of
memory SCSI reserves for itself. The formula is rather memory SCSI reserves for itself. The formula is rather
complicated, but I can give you some hints: complicated, but I can give you some hints:
no scatter-gather : cmd_per_lun * 232 bytes
full scatter-gather: cmd_per_lun * approx. 17 Kbytes no scatter-gather:
cmd_per_lun * 232 bytes
full scatter-gather:
cmd_per_lun * approx. 17 Kbytes
<scat-gat>: <scat-gat>:
Size of the scatter-gather table, i.e. the number of requests Size of the scatter-gather table, i.e. the number of requests
@ -634,19 +659,23 @@ ignored (others aren't affected).
4.5 switches= 4.5 switches=
------------- -------------
Syntax: switches=<list of switches> :Syntax: switches=<list of switches>
With this option you can switch some hardware lines that are often With this option you can switch some hardware lines that are often
used to enable/disable certain hardware extensions. Examples are used to enable/disable certain hardware extensions. Examples are
OverScan, overclocking, ... OverScan, overclocking, ...
The <list of switches> is a comma-separated list of the following The <list of switches> is a comma-separated list of the following
items: items:
ikbd: set RTS of the keyboard ACIA high ikbd:
midi: set RTS of the MIDI ACIA high set RTS of the keyboard ACIA high
snd6: set bit 6 of the PSG port A midi:
snd7: set bit 6 of the PSG port A set RTS of the MIDI ACIA high
snd6:
set bit 6 of the PSG port A
snd7:
set bit 6 of the PSG port A
It doesn't make sense to mention a switch more than once (no It doesn't make sense to mention a switch more than once (no
difference to only once), but you can give as many switches as you difference to only once), but you can give as many switches as you
@ -654,16 +683,16 @@ want to enable different features. The switch lines are set as early
as possible during kernel initialization (even before determining the as possible during kernel initialization (even before determining the
present hardware.) present hardware.)
All of the items can also be prefixed with "ov_", i.e. "ov_ikbd", All of the items can also be prefixed with `ov_`, i.e. `ov_ikbd`,
"ov_midi", ... These options are meant for switching on an OverScan `ov_midi`, ... These options are meant for switching on an OverScan
video extension. The difference to the bare option is that the video extension. The difference to the bare option is that the
switch-on is done after video initialization, and somehow synchronized switch-on is done after video initialization, and somehow synchronized
to the HBLANK. A speciality is that ov_ikbd and ov_midi are switched to the HBLANK. A speciality is that ov_ikbd and ov_midi are switched
off before rebooting, so that OverScan is disabled and TOS boots off before rebooting, so that OverScan is disabled and TOS boots
correctly. correctly.
If you give an option both, with and without the "ov_" prefix, the If you give an option both, with and without the `ov_` prefix, the
earlier initialization ("ov_"-less) takes precedence. But the earlier initialization (`ov_`-less) takes precedence. But the
switching-off on reset still happens in this case. switching-off on reset still happens in this case.
5) Options for Amiga Only: 5) Options for Amiga Only:
@ -672,10 +701,10 @@ switching-off on reset still happens in this case.
5.1) video= 5.1) video=
----------- -----------
Syntax: video=<fbname>:<sub-options...> :Syntax: video=<fbname>:<sub-options...>
The <fbname> parameter specifies the name of the frame buffer, valid The <fbname> parameter specifies the name of the frame buffer, valid
options are `amifb', `cyber', 'virge', `retz3' and `clgen', provided options are `amifb`, `cyber`, 'virge', `retz3` and `clgen`, provided
that the respective frame buffer devices have been compiled into the that the respective frame buffer devices have been compiled into the
kernel (or compiled as loadable modules). The behavior of the <fbname> kernel (or compiled as loadable modules). The behavior of the <fbname>
option was changed in 2.1.57 so it is now recommended to specify this option was changed in 2.1.57 so it is now recommended to specify this
@ -697,9 +726,11 @@ predefined video modes are available:
NTSC modes: NTSC modes:
- ntsc : 640x200, 15 kHz, 60 Hz - ntsc : 640x200, 15 kHz, 60 Hz
- ntsc-lace : 640x400, 15 kHz, 60 Hz interlaced - ntsc-lace : 640x400, 15 kHz, 60 Hz interlaced
PAL modes: PAL modes:
- pal : 640x256, 15 kHz, 50 Hz - pal : 640x256, 15 kHz, 50 Hz
- pal-lace : 640x512, 15 kHz, 50 Hz interlaced - pal-lace : 640x512, 15 kHz, 50 Hz interlaced
ECS modes: ECS modes:
- multiscan : 640x480, 29 kHz, 57 Hz - multiscan : 640x480, 29 kHz, 57 Hz
- multiscan-lace : 640x960, 29 kHz, 57 Hz interlaced - multiscan-lace : 640x960, 29 kHz, 57 Hz interlaced
@ -715,6 +746,7 @@ ECS modes:
- dblpal-lace : 640x1024, 27 kHz, 47 Hz interlaced - dblpal-lace : 640x1024, 27 kHz, 47 Hz interlaced
- dblntsc : 640x200, 27 kHz, 57 Hz doublescan - dblntsc : 640x200, 27 kHz, 57 Hz doublescan
- dblpal : 640x256, 27 kHz, 47 Hz doublescan - dblpal : 640x256, 27 kHz, 47 Hz doublescan
VGA modes: VGA modes:
- vga : 640x480, 31 kHz, 60 Hz - vga : 640x480, 31 kHz, 60 Hz
- vga70 : 640x400, 31 kHz, 70 Hz - vga70 : 640x400, 31 kHz, 70 Hz
@ -726,7 +758,7 @@ chipset and 8-bit color for the AGA chipset.
5.1.2) depth 5.1.2) depth
------------ ------------
Syntax: depth:<nr. of bit-planes> :Syntax: depth:<nr. of bit-planes>
Specify the number of bit-planes for the selected video-mode. Specify the number of bit-planes for the selected video-mode.
@ -739,32 +771,32 @@ Use inverted display (black on white). Functionally the same as the
5.1.4) font 5.1.4) font
----------- -----------
Syntax: font:<fontname> :Syntax: font:<fontname>
Specify the font to use in text modes. Functionally the same as the Specify the font to use in text modes. Functionally the same as the
"font" sub-option for the Atari, except that `PEARL8x8' is used instead "font" sub-option for the Atari, except that `PEARL8x8` is used instead
of `VGA8x8' if the vertical size of the display is less than 400 pixel of `VGA8x8` if the vertical size of the display is less than 400 pixel
rows. rows.
5.1.5) monitorcap: 5.1.5) monitorcap:
------------------- -------------------
Syntax: monitorcap:<vmin>;<vmax>;<hmin>;<hmax> :Syntax: monitorcap:<vmin>;<vmax>;<hmin>;<hmax>
This describes the capabilities of a multisync monitor. For now, only This describes the capabilities of a multisync monitor. For now, only
the color frame buffer uses the settings of "monitorcap:". the color frame buffer uses the settings of "monitorcap:".
<vmin> and <vmax> are the minimum and maximum, resp., vertical frequencies <vmin> and <vmax> are the minimum and maximum, resp., vertical frequencies
your monitor can work with, in Hz. <hmin> and <hmax> are the same for your monitor can work with, in Hz. <hmin> and <hmax> are the same for
the horizontal frequency, in kHz. the horizontal frequency, in kHz.
The defaults are 50;90;15;38 (Generic Amiga multisync monitor). The defaults are 50;90;15;38 (Generic Amiga multisync monitor).
5.2) fd_def_df0= 5.2) fd_def_df0=
---------------- ----------------
Syntax: fd_def_df0=<value> :Syntax: fd_def_df0=<value>
Sets the df0 value for "silent" floppy drives. The value should be in Sets the df0 value for "silent" floppy drives. The value should be in
hexadecimal with "0x" prefix. hexadecimal with "0x" prefix.
@ -773,7 +805,7 @@ hexadecimal with "0x" prefix.
5.3) wd33c93= 5.3) wd33c93=
------------- -------------
Syntax: wd33c93=<sub-options...> :Syntax: wd33c93=<sub-options...>
These options affect the A590/A2091, A3000 and GVP Series II SCSI These options affect the A590/A2091, A3000 and GVP Series II SCSI
controllers. controllers.
@ -784,9 +816,9 @@ below.
5.3.1) nosync 5.3.1) nosync
------------- -------------
Syntax: nosync:bitmask :Syntax: nosync:bitmask
bitmask is a byte where the 1st 7 bits correspond with the 7 bitmask is a byte where the 1st 7 bits correspond with the 7
possible SCSI devices. Set a bit to prevent sync negotiation on that possible SCSI devices. Set a bit to prevent sync negotiation on that
device. To maintain backwards compatibility, a command-line such as device. To maintain backwards compatibility, a command-line such as
"wd33c93=255" will be automatically translated to "wd33c93=255" will be automatically translated to
@ -796,35 +828,35 @@ all devices, eg. nosync:0xff.
5.3.2) period 5.3.2) period
------------- -------------
Syntax: period:ns :Syntax: period:ns
`ns' is the minimum # of nanoseconds in a SCSI data transfer `ns` is the minimum # of nanoseconds in a SCSI data transfer
period. Default is 500; acceptable values are 250 - 1000. period. Default is 500; acceptable values are 250 - 1000.
5.3.3) disconnect 5.3.3) disconnect
----------------- -----------------
Syntax: disconnect:x :Syntax: disconnect:x
Specify x = 0 to never allow disconnects, 2 to always allow them. Specify x = 0 to never allow disconnects, 2 to always allow them.
x = 1 does 'adaptive' disconnects, which is the default and generally x = 1 does 'adaptive' disconnects, which is the default and generally
the best choice. the best choice.
5.3.4) debug 5.3.4) debug
------------ ------------
Syntax: debug:x :Syntax: debug:x
If `DEBUGGING_ON' is defined, x is a bit mask that causes various If `DEBUGGING_ON` is defined, x is a bit mask that causes various
types of debug output to printed - see the DB_xxx defines in types of debug output to printed - see the DB_xxx defines in
wd33c93.h. wd33c93.h.
5.3.5) clock 5.3.5) clock
------------ ------------
Syntax: clock:x :Syntax: clock:x
x = clock input in MHz for WD33c93 chip. Normal values would be from x = clock input in MHz for WD33c93 chip. Normal values would be from
8 through 20. The default value depends on your hostadapter(s), 8 through 20. The default value depends on your hostadapter(s),
default for the A3000 internal controller is 14, for the A2091 it's 8 default for the A3000 internal controller is 14, for the A2091 it's 8
and for the GVP hostadapters it's either 8 or 14, depending on the and for the GVP hostadapters it's either 8 or 14, depending on the
@ -834,15 +866,15 @@ hostadapters.
5.3.6) next 5.3.6) next
----------- -----------
No argument. Used to separate blocks of keywords when there's more No argument. Used to separate blocks of keywords when there's more
than one wd33c93-based host adapter in the system. than one wd33c93-based host adapter in the system.
5.3.7) nodma 5.3.7) nodma
------------ ------------
Syntax: nodma:x :Syntax: nodma:x
If x is 1 (or if the option is just written as "nodma"), the WD33c93 If x is 1 (or if the option is just written as "nodma"), the WD33c93
controller will not use DMA (= direct memory access) to access the controller will not use DMA (= direct memory access) to access the
Amiga's memory. This is useful for some systems (like A3000's and Amiga's memory. This is useful for some systems (like A3000's and
A4000's with the A3640 accelerator, revision 3.0) that have problems A4000's with the A3640 accelerator, revision 3.0) that have problems
@ -853,32 +885,27 @@ possible.
5.4) gvp11= 5.4) gvp11=
----------- -----------
Syntax: gvp11=<addr-mask> :Syntax: gvp11=<addr-mask>
The earlier versions of the GVP driver did not handle DMA The earlier versions of the GVP driver did not handle DMA
address-mask settings correctly which made it necessary for some address-mask settings correctly which made it necessary for some
people to use this option, in order to get their GVP controller people to use this option, in order to get their GVP controller
running under Linux. These problems have hopefully been solved and the running under Linux. These problems have hopefully been solved and the
use of this option is now highly unrecommended! use of this option is now highly unrecommended!
Incorrect use can lead to unpredictable behavior, so please only use Incorrect use can lead to unpredictable behavior, so please only use
this option if you *know* what you are doing and have a reason to do this option if you *know* what you are doing and have a reason to do
so. In any case if you experience problems and need to use this so. In any case if you experience problems and need to use this
option, please inform us about it by mailing to the Linux/68k kernel option, please inform us about it by mailing to the Linux/68k kernel
mailing list. mailing list.
The address mask set by this option specifies which addresses are The address mask set by this option specifies which addresses are
valid for DMA with the GVP Series II SCSI controller. An address is valid for DMA with the GVP Series II SCSI controller. An address is
valid, if no bits are set except the bits that are set in the mask, valid, if no bits are set except the bits that are set in the mask,
too. too.
Some versions of the GVP can only DMA into a 24 bit address range, Some versions of the GVP can only DMA into a 24 bit address range,
some can address a 25 bit address range while others can use the whole some can address a 25 bit address range while others can use the whole
32 bit address range for DMA. The correct setting depends on your 32 bit address range for DMA. The correct setting depends on your
controller and should be autodetected by the driver. An example is the controller and should be autodetected by the driver. An example is the
24 bit region which is specified by a mask of 0x00fffffe. 24 bit region which is specified by a mask of 0x00fffffe.
/* Local Variables: */
/* mode: text */
/* End: */