mdverify

Purpose

     Controls write-verify operation for a minidisk.

Library

     Run-time Services Library (librts.a)

Syntax

     #include <mdverify.h>

     int mdverify (md, req)
     char *md;
     char req;

Description

     The mdverify  subroutine turns write-verify  operation on
     or off for a given minidisk.  When write-verify operation
     is turned on,  the system checks each  write operation to
     the minidisk.  After data is written, the system reads it
     and compares it with the data in the write buffer.  If an
     uncorrectable error  is detected,  then an error  code is
     passed back from the write operation.

     The md parameter  is a string that specifies  the name of
     the minidisk as  it appears in the  /etc/system file (for
     example, ""hd1"").  The req parameter  is one of the fol-
     lowing values:

     "'v'" Turns write-verify operation on.
     "'o'" Turns write-verify operation off.
     "'q'" Queries the current write-verify status.

Return Value

     Upon successful  completion of a "'v'"  or "'o'" request,
     the mdverify  subroutine returns a value  of MDV_succ.  A
     successful  "'q'" request  returns one  of the  following
     values:

     MDV_wvon    Write-verify  operation  is currently  turned
                 on.
     MDV_wvoff   Write-verify  operation  is currently  turned
                 off.

     If the mdverify subroutine fails,  then it returns one of
     the following values:

     -1          The error is indicated by the value of errno.

     MDV_open    The /etc/system file could not be opened.

     MDV_nosd    The  md parameter  does not  specify a  valid
                 minidisk name.

     MDV_iarg    The req parameter is not valid.

     MDV_csf     The IODN could not  be found, indicating that
                 the  /etc/system   file  has   probably  been
                 damaged.

     MDV_iiodn   The  minidisk  manager  detected  an  invalid
                 minidisk IODN.

     MDV_dioe    The minidisk  manager encountered a  disk I/O
                 error.

     MDV_iop     The minidisk  manager encountered  an invalid
                 operation mode.

File

     /etc/system

Related Information

     In this book:   "system" and the VQUERY  and VCNTRL ioctl
     operations described in "hd."

     The verify command in  AIX Operating System Commands Ref-
     erence.