getdev.c revision 7c478bd95313f5f23a4c958a745db2134aa03244
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2002-2003 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
/* Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */
/* All Rights Reserved */
#pragma ident "%Z%%M% %I% %E% SMI"
/*
* getdev.c
*
* Contains
* getdev Writes on the standard output stream a list of devices
* that match certain criteria.
*/
#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
#include <string.h>
#include <fmtmsg.h>
#include <devmgmt.h>
#include <devtab.h>
/*
* Local Definitions
* TRUE Boolean TRUE value
* FALSE Boolean FALSE value
* EX_OK Exit Value if all went well
* EX_ERROR Exit Value if an error occurred
* EX_DEVTAB Exit Value if the device table couldn't be opened
*/
#ifndef TRUE
#define TRUE (1)
#endif
#ifndef FALSE
#define FALSE (0)
#endif
#define EX_OK 0
#define EX_ERROR 1
#define EX_DEVTAB 2
/*
* Messages:
* M_USAGE Usage error
* M_DEVTAB Can't open the device table
* M_NODEV Device not found in the device table
* M_ERROR Unexpected or internal error
*/
#define M_USAGE "usage: getdev [-ae] [criterion [...]] [device [...]]"
#define M_DEVTAB "Cannot open the device table: %s"
#define M_NODEV "Device not found in the device table: %s"
#define M_ERROR "Internal error, errno=%d"
/*
* Local (Static) Definitions and macros
* buildcriterialist() Builds the criteria list from the command-line
* builddevlist() Builds the device list from the command-line
* lbl Buffer for the standard message label
* txt Buffer for the standard message text
* stdmsg(r,l,s,t) Write a standard message:
* r Recoverability flag
* l Standard label
* s Severity
* t Text
*/
static char **buildcriterialist();
static char **builddevlist();
/*
* getdev [-ae] [criterion [...]] [device [...]]
*
* This command generates a list of devices that match the
* specified criteria.
*
* Options:
* -a A device must meet all of the criteria to be
* included in the generated list instead of just
* one of the criteria (the "and" flag)
* -e Exclude the devices mentioned from the generated
* list. If this flag is omitted, the devices in the
* list are selected from the devices mentioned.
*
* Arguments:
* criterion An <attr><op><value> expression that describes
* a device attribute.
* <attr> is a device attribute
* <op> may be = != : !: indicating equals, does not
* equal, is defined, and is not defined
* respectively
* <value> is the attribute value. Currently, the only
* value supported for the : and !: operators
* is *
* device A device to select for or exclude from the generated
* list
*
* Exit values:
* EX_OK All went well
* EX_ERROR An error (syntax, internal, or resource) occurred
* EX_DEVTAB The device-table could not be opened for reading
*/
int argc; /* Number of items on the command line */
char **argv; /* List of pointers to the arguments */
{
/*
* Automatic data
*/
char **arglist; /* List of arguments */
char **criterialist; /* List of criteria */
char **devicelist; /* List of devices to search/ignore */
char **fitdevlist; /* List of devices that fit criteria */
char *cmdname; /* Simple command name */
char *device; /* Device name in the list */
char *devtab; /* The device table name */
int exitcode; /* Value to return to the caller */
int sev; /* Message severity */
int optchar; /* Option character (from getopt()) */
int andflag; /* TRUE if criteria are to be anded */
int excludeflag; /* TRUE if exclude "devices" lists */
int options; /* Options to pass to getdev() */
int usageerr; /* TRUE if syntax error */
/* Build the message label from the (simple) command name */
/* Write text-component of messages only (goes away in SVR4.1) */
(void) putenv("MSGVERB=text");
/*
* Parse the command line:
* - Options
* - Selection criteria
* - Devices to include or exclude
*/
/*
* Extract options from the command line
*/
/* Initializations */
/*
* Loop until all of the command line options have been parced
*/
/* -a List devices that fit all of the criteria listed */
case 'a':
break;
/* -e Exclude those devices mentioned on the command line */
case 'e':
else excludeflag = TRUE;
break;
/* Default case -- command usage error */
case '?':
default:
break;
}
/* If there is a usage error, write an appropriate message and exit */
if (usageerr) {
}
/* Open the device file (if there's one to be opened) */
if (!_opendevtab("r")) {
if (devtab = _devtabpath()) {
} else {
}
}
/* Build the list of criteria and devices */
/*
* Get the list of devices that meets the criteria requested. If we
* got a list (that might be empty), write that list to the standard
* output file (stdout).
*/
exitcode = 0;
exitcode = 1;
}
/* Finished */
return(exitcode);
}
/*
* char **buildcriterialist(arglist)
* char **arglist
*
* Build a list of pointers to the criterion on the command-line
*
* Arguments:
* arglist The list of arguments on the command-line
*
* Returns: char **
* The address of the first item of the list of criterion on the
* command-line. This is a pointer to malloc()ed space.
*/
static char **
char **arglist; /* Pointer to the list of argument pointers */
{
/*
* Automatic data
*/
char **pp; /* Pointer to a criteria */
char **allocbuf; /* Pointer to the allocated data */
int ncriteria; /* Number of criteria found */
/*
* Search the argument list, looking for the end of the list or
* the first thing that's not a criteria. (A criteria is a
* character-string that contains a colon (':') or an equal-sign ('=')
*/
ncriteria = 0;
ncriteria++;
pp++;
}
if (ncriteria > 0) {
/* Allocate space for the list of criteria pointers */
/*
* Build the list of criteria arguments
*/
while (*arglist && /* If there's more to do ... */
return (allocbuf);
}
/*
* char **builddevlist(arglist)
* char **arglist
*
* Builds a list of pointers to the devices mentioned on the command-
* line and returns the address of that list.
*
* Arguments:
* arglist The address of the list of arguments to the
* getdev command.
*
* Returns: char **
* A pointer to the first item in the list of pointers to devices
* specified on the command-line
*/
static char **
char **arglist; /* Pointer to the list of pointers to args */
{
/*
* Automatic data
*/
/*
* Search the argument list, looking for the end of the list or the
* first thing that's not a criteria. It is the first device in the
* list of devices (if any).
*/
/* Return a pointer to the argument list. */
}