File: nvram.8

package info (click to toggle)
nvram 0.1-7
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k, sarge
  • size: 56 kB
  • ctags: 70
  • sloc: ansic: 598; makefile: 50; sh: 33
file content (188 lines) | stat: -rw-r--r-- 6,640 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
.\" Copyright (c) 1997 Roman Hodek
.\" 
.\"	nvram and this man page are free software.  You can redistribute
.\"	it and/or modify it under the terms of the GNU General Public License as
.\"	published by the Free Software Foundation: either version 2 or
.\"	(at your option) any later version.
.\"
.TH NVRAM 8 "July 12 1997" "Linux" "MAINTENANCE COMMANDS"
.SH NAME
nvram \- display and change permanent settings in Atari non-volatile RAM
.SH SYNOPSIS
.B nvram
[
.B -b
.I bootpref
|
.B \-\-boot\-preference=
.I bootpref
]
[
.B -c
|
.B \-\-recalculate\-checksum
]
[
.B -d
.I delay
|
.B \-\-boot\-delay=
.I delay
]
[
.B -D
.I dateformat
|
.B \-\-date\-format=
.I dateformat
]
[
.B -i
|
.B \-\-init\-nvram
]
[
.B -k
.I language
|
.B \-\-keyboard\-language=
.I language
]
[
.B -l
.I language
|
.B \-\-language=
.I language
]
[
.B -s
.I scsi-id
|
.B \-\-scsi\-id=
.I scsi-id
]
[
.B -t
12|24[h]
|
.B \-\-time\-format=
12|24[h]
]
[
.B -v
.I video-mode
|
.B \-\-video\-mode=
.I video-mode
]
[
.B -V
|
.B \-\-version
]
.SH DESCRIPTION
.B nvram
is used to display and modify the permanent settings in the
non-volatile memory of the RTC that is built into several Atari
machines (TT, Falcon, Medusa, ...)
.PP
If called without any arguments, it display all settings in the NVRAM.
Note that TOS versions before 4.00 (i.e., all machines except the
Falcon) ignore all settings except the boot preference and the
SCSI-ID. (But the latter is used by the hard disk driver, not by TOS
itself.) But you could read those values (e.g. language, keyboard
language) during Linux' boot process and set up things accordingly.
.SH OPTIONS
.TP
.IP "\fB\-b \fIbootpref\fR, \fB\-\-boot\-preference=\fIbootpref\fR"
This value determines which OS to boot, in conjunction with the boot
types in partition descriptors. With other words, you select which
partition to boot from. Possible values for \fIbootpref\fR are:
\fBunspecified\fR (0x00), \fBTOS\fR, \fBGEMDOS\fR (0x80),
\fBAtariSystemV\fR, \fBSystemV\fR, \fBSysV\fR, \fBASV\fR (0x40),
\fBNetBSD\fR, \fBBSD\fR (0x20), and \fBLinux\fR (0x10) (unique
abbreviations possible, case-insensitive). You can also use a
hexadecimal number with 0x prefix, but only powers of two from 0x08 to
0x80 are allowed. The value \fBunspecified\fR (0x00) means to boot a
default OS, usually TOS, but decided by the boot code in the root
sector.
.IP "\fB\-c\fR, \fB\-\-recalculate\-checksum\fR"
Recalculate the checksum over NVRAM contents, without changing the
contents themselves. This can be useful if only the checksum has been
destroyed somehow, or you modified the NVRAM by hand (not possible
under Linux). This option can be used only alone, and you must be
root.
.IP "\fB\-d \fIdelay\fR, \fB\-\-boot\-delay=\fIdelay\fR"
The boot process pauses \fIdelay\fR seconds, to give hard disks a
chance to initialize. The value 0 stands for some default delay.
Values less than or equal 8 also omit the memory test on cold boots.
.IP "\fB\-D \fIdateformat\fR, \fB\-\-date\-format=\fIdateformat\fR"
Determines which date format is used under TOS (but not all
application care...) \fIdateformat\fR can be something like
\fBMM\-DD\-YY\fR, i.e. some permutation of \fBDD\fR, \fBMM\fR, and
\fBYY\fR with a separator character between them. The separators must
be equal and are also stored in NV-RAM.
.IP "\fB\-i\fR, \fB\-\-init\-nvram\fR"
Completely initialize the whole NV-RAM, i.e. fill it with zeros
(default values) and set the checksum. This erases all previous
settings! This option can be used only alone, and you must be root.
.IP "\fB\-k \fIlanguage\fR, \fB\-\-keyboard\-language=\fIlanguage\fR"
Determines the nationality of the keyboard. Used by TOS to set up the
keyboard translation tables. You could also use the value in a
/etc/init.d/rc.boot script to set up the matching keyboard mapping
under Linux. Possible values are: \fBEnglish (US)\fR,
\fBEnglish(us)\fR, \fBEnglish\fR, \fBUS-English\fR, \fBEnglish-US\fR,
\fBGerman\fR, \fBFrench\fR, \fBEnglish (UK)\fR, \fBEnglish (GB)\fR,
\fBEnglish(uk)\fR, \fBEnglish(gb)\fR, \fBUK-English\fR,
\fBGB-English\fR, \fBEnglish-UK\fR, \fBEnglish-GB\fR, \fBSpanish\fR,
\fBItalian\fR, \fBSwiss(French)\fR, \fBSwiss-fr\fR,
\fBSwiss(German)\fR, and \fBSwiss-de\fR. Matching is case-insensitive
and unique abbreviations are possible.
.IP "\fB\-l \fIlanguage\fR, \fB\-\-language=\fIlanguage\fR"
Sets the language used by TOS in dialogs and the like. Under Linux,
could be used e.g. to initialize a LANG environment variable. Possible
values are the same as above for \-\-keyboard\-language.
.IP "\fB\-s \fIscsi-id\fR, \fB\-\-scsi\-id=\fIscsi-id\fR"
Tells the TOS hard disk driver whether it should use SCSI arbitration,
and if yes, which SCSI ID to use for the host adapter. Possible values
for \fIscsi-id\fR are \fBoff\fR (no arbitration), and numbers from 0
to 7 (7 is the most common value). Linux always works with
arbitration, but uses the host ID from NVRAM, if it its valid (i.e.,
if arbitration is enabled).
.IP "\fB\-t \fItimeformat\fR, \fB\-\-time\-format=\fItimeformat\fR"
Determines whether TOS uses a 12h hour clock (with am/pm), or a 24h
clock. Possible values for \fItimeformat\fR are \fB12h\fR or \fB24h\fR
(the trailing '\fBh\fR' is optional).
.IP "\fB\-v \fIvideomode\fR, \fB\-\-video\-mode=\fIvideomode\fR"
This sets the video mode and related things used by TOS after booting.
\fIvideomode\fR is a comma-separated list of sub-options, some of them
taking an argument after a '='. The suboptions are:
.RS
.IP "\fBcolors=\fInum\fR"
Set numbers of colors (resolution mode). Possible values are 2, 4, 16,
256, and 65536.
.IP "\fBcolumns=\fInum\fR, \fBcol40\fR, \fBcol80\fR"
Set number of text columns in video mode. \fInum\fR can be only 40 or
80.
.IP "\fBtv\fR, \fBvga\fR"
Monitor type, TV or VGA monitor attached (mutually exclusive).
.IP "\fBntsc\fR, \fBpal\fR"
Monitor uses US NTSC or European PAL mode.
.IP "\fBoverscan\fR[\fB=\fInum\fR], \fBno-overscan\fR"
Turns overscan mode on (\fInum\fR not zero) or off (\fInum\fR zero, or
\fBno-overscan\fR). If the argument to \fBoverscan\fR is missing, turns
overscan on.
.IP "\fBcompat\fR[\fB=\fInum\fR], \fBno-compat\fR"
Turns ST compability modes (e.g. ST-High, 640x400 monochrome) on
(\fInum\fR not zero) or off (\fInum\fR zero, or \fBno-compat\fR). If
the argument to \fBcompat\fR is missing, turns overscan on.
.IP "\fBdouble\fR[\fB=\fInum\fR], \fBno-double\fR"
Turns on or off line doubling mode for VGA monitors. \fInum\fR same as
above.
.IP "\fBhalf\fR[\fB=\fInum\fR], \fBno-half\fR"
Turns on or off half-picture mode for TV monitors. \fInum\fR same as
above.
.RE
.SH AUTHOR
Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>