#
# Copyright (c) 2000-2001 Silicon Graphics, Inc.  All Rights Reserved.
# 
# This program is free software; you can redistribute it and/or modify it
# under the terms of version 2 of the GNU General Public License as
# published by the Free Software Foundation.
# 
# This program is distributed in the hope that it would be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# 
# Further, this software is distributed without any warranty that it is
# free of the rightful claim of any third person regarding infringement
# or the like.  Any license provided herein, whether implied or
# otherwise, applies only to this software file.  Patent licenses, if
# any, provided herein do not apply to combinations of this program with
# other software, or any other product whatsoever.
# 
# You should have received a copy of the GNU General Public License along
# with this program; if not, write the Free Software Foundation, Inc., 59
# Temple Place - Suite 330, Boston MA 02111-1307, USA.
# 
# Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
# Mountain View, CA  94043, or:
# 
# http://www.sgi.com 
# 
# For further information regarding this notice, see: 
# 
# http://oss.sgi.com/projects/GenInfo/SGIGPLNoticeExplan/

###  README for check_dmapi  ###

check_dmapi tests the version of DMAPI library & kernel code.

command line:  check_dmapi [-v] 
(v is a verbose-output flag)

Functionality:

1) Ensures that the user is running as root, using getuid().  

2) Tries to stat() /usr/include/sys/dmi.h to verify its
   presence and its size.

3) Verifies the presence of the DMAPI kernel, using a 
   direct call to dmi().  The call is invalid, so it should
   return EINVAL if the kernel code is in place, ENOPKG if not.

4) Determines the status of the kernel (if it is present) using
   a direct call to dmi().  The call is invalid, and uses an opcode
   not present in the old kernel.  So ENOSYS means old kernel;
   EINVAL means new kernel.

5) Determines the status of the library by calling dm_init_service().
   If this fails, libraries are missing.  In the old library, this call
   did not change its "name" parameter, but in the new library it does.
   Same name means old library; changed name means new library. 

6) Outputs its findings.