presto.4

来自「<B>Digital的Unix操作系统VAX 4.2源码</B>」· 4 代码 · 共 491 行 · 第 1/2 页

.TP
PRENABLE
The argument to ioctl is a pointer to a
.BR dev_t .
This enables Prestoserve caching on the specified file system or block
device.
.TP
PRDISABLE
The argument to ioctl is a pointer to a
.BR dev_t .
If all cached data for the specified file system or block device
can be successfully written
to disk, Prestoserve caching is disabled for this file system or
block device.
.SH Diagnostics
.B "Prestoserve license not registered"
.br
This message is displayed if you attempt to use Prestoserve 
on a system that has not had its license registered. It is necessary to
register a valid license in order to use Prestoserve.
.PP
.B "presto: using %d bytes of NVRAM at 0x%x"
.br
This message is displayed at boot time and indicates that Prestoserve 
recognized its control information portion of the cache.
It is a normal Prestoserve startup message.
.PP
.B "presto: initializing %d bytes of NVRAM at 0x%x"
.br
This message is displayed at boot time and indicates that Prestoserve did not
recognize the cache as being in either a clean (containing no data) or a 
dirty (containing data) state.
The message is usually displayed when the cache is used for the first time,
after the cache has been cleared by using a diagnostic command, or
after backup battery failure.
.PP
.B "presto: NVRAM tested %s"
.br
This message is displayed at boot time, and it indicates that the cache 
tested as either "read/write ok" or "readonly ok."
The message is a normal Prestoserve startup message.
.PP
.B "presto: %s battery %s"
.br
The status for the primary battery or a secondary 
battery, if applicable, is reported as either 
.B OK , 
.B LOW , 
or 
.B DISABLED .
This message is displayed at boot time and when there is a change
in the state of the backup battery power level.
.PP
.B "presto: cache contains dirty data"
.br
This message is displayed at boot time if Prestoserve
was not shut down by using the normal system shutdown procedures.
.PP
.B "presto: %d dirty buffers found"
.br
This message indicates that dirty buffers
were found after the system rebooted.
The data is written to the intended disks as soon as possible,
usually when the first I/O request occurs for any accelerated device.
.PP
.B "presto: writing dirty buffers"
.br
This message indicates that Prestoserve has begun to write the data in
the dirty buffers to the intended disks.
.PP
.B "presto: dirty buffers written"
.br
This message indicates that the data in the dirty buffers has been
successfully written to the intended disks. 
.PP
.B "presto: using software version %d -- version %d last used"
.br
This message is displayed at boot time and indicates that the kernel 
is now being run with a version of the Prestoserve software that is
different from the version used previously.  Usually, this message is 
displayed when you first boot the system after performing 
a software upgrade.
.PP
.B "presto: expected sizes %d, %d -- found %d, %d"
.br
This message indicates that the block size and fragment size 
in the Prestoserve control information portion of the cache are
different from the information that was expected.
This message should only be displayed when you first boot the system after 
performing a software upgrade.
.PP
.B "presto: NVRAM increased from %d to %d bytes at 0x%x"
.br
This message indicates that only a portion 
of the Prestoserve cache was being used when the system was shut down,
but now Prestoserve is using the entire cache.  The 
.PN "presto \-s" 
command, which changes the size of the Prestoserve cache, is described
in 
.MS presto 8
in the \fIULTRIX Reference Pages\fP.
.PP
.B "presto: decreased from %d to %d bytes!"
.br
This message indicates that a hardware or software problem exists
because the size of the Prestoserve cache at reboot is less
than the size of the cache when the system shut down.
.PP
.B "presto: dirty buffers found for host id 0x%x,"
.br
.B "which is different from this host's id (0x%x)"
.br
This message is displayed at boot time and indicates that Prestoserve
was not shut down normally and that the cache contents were previously in a
different system (for example, either the cache was moved or the system
ID, which is usually the on-board Ethernet hardware address, has changed).
Prestoserve allows you to do one of the following interactively:
discard the data, write the data to disk, or halt the machine.
.PP
.B "The Prestoserve cache failed memory self-tests."
.br
.B "The cache may contain data which has not been written to disk yet."
.br
When these messages are displayed, Prestoserve allows you to do one of the
following interactively:  continue with the boot or halt the machine.
.PP
.B "presto: error %d opening dev (%d, %d), skipping writing of its buffers..."
.br
This message indicates that dirty Prestoserve buffers were found after
the system rebooted, 
and the data in the dirty buffers could not be written to the specified device
because the device failed to open.  You should verify that the
device is online and that the kernel successfully found the device at boot time.
Refer to 
.MS errno 2
in the \fIULTRIX Reference Pages\fP for a complete description of the error.
.PP
.B "presto: error %d opening block device (%d, %d)"
.br
This message indicates that the specified device failed to open.
You should check your disk configuration and make sure that the drive is on
line.  Refer to 
.MS errno 2
in the \fIULTRIX Reference Pages\fP for a complete description of the error.
.PP
.B "presto: error %d ioctl'ing dev (%d, %d)"
.br
This message indicates that an ioctl failed for the specified device.
Refer to 
.MS errno 2
in the \fIULTRIX Reference Pages\fP for a complete description of the error.
.PP
.B "presto: can NOT do direct I/0 for block device (%d, %d)"
.br
.B "presto: using block device (%d, %d) in `bounceio' mode"
.br
These messages indicate that the disk controller for the specified device
could not directly address the cache when Prestoserve was 
enabled on the file system or block device.  Refer to the \fIGuide to Prestoserve\fP
for information about bounceio state.
.PP
.B "presto: flush dirty buffers"
.br
This message is displayed when Prestoserve is in the PRERROR
state and receives a request to write the data in a dirty buffer to 
the intended disks.
.PP
.B "presto: Block device %d not present or is not Presto-ized in this kernel!"
.br
This message indicates that Prestoserve
was not shut down cleanly, and the system was previously running a kernel
with an accelerated device that the current kernel does not accelerate.
You should boot a kernel that accelerates all the devices that were
previously accelerated.
.PP
.B "presto: NVRAM probe error"  
.br
This message is displayed at system startup if a Prestoserve cache 
read/write error occurred, and it indicates that the cache could not be accessed.
It indicates a hardware or software error.
.PP
.B "presto: failed to write and read 0x%x from 0x%x"
.br
This message indicates that the Prestoserve cache failed the read/write test
at the specified address.
.PP
.B "presto: error on dev (%d, %d)"
.br
This message indicates that an I/O error occurred on the specified disk 
during a Prestoserve write-back operation.
.PP
.B "presto: not enough backup battery power!"
.br
This message indicates that there is inadequate backup battery power.
Prestoserve attempts to write all Prestoserve cache data to the
intended disks and then enters the PRERROR state.
.PP
.B "presto: disabling..."
.br
This message indicates that Prestoserve disabled itself because of 
inadequate backup battery power or because a disk error occurred 
during a write to disk.
.PP
.B "presto: back online!"
.br
This message indicates that a disk error or low backup battery power 
condition has been corrected and that Prestoserve is enabled again.
.SS Errors
.TP 12
[EACCESS]
Indicates that Prestoserve is not registered for use on this system.
.TP
[EPERM]
Indicates that a caller whose uid is not root tried to use the
PRSETSTATE, PRSETMEMSZ, PRRESET, PRENABLE or PRDISABLE command.
.TP
[EBUSY]
Indicates that you tried to use the PRSETSTATE, PRSETMEMSZ, or
PRDISABLE command, but a fatal disk error or a battery problem exists.
.TP
[ENOMEM]
Indicates that the memory size you specified in the PRSETSTATE
command exceeds the maximum size of the cache reported in the
.B presto_status
structure.
.TP
[ENODEV] 
Indicates that Prestoserve
was not successfully started at boot time, or it indicates that you used 
the PRENABLE or PRDISABLE command and the device 
specified by dev_t is not a device initialized for use with Prestoserve 
or an error occurred in trying to open/ioctl the device.
.TP
[EINVAL]
Indicates that an invalid argument was specified with the PRSETMEMSZ 
or PRSETSTATE command or that an invalid command was used.
.SH Files
.TP 28
.PN /dev/pr0
Generic Prestoserve control device
.SH See Also
errno(2), ioctl(2), presto(8), dxpresto(8X), prestoctl_svc(8)
.br
\fIGuide to Prestoserve\fP