/* * 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 * or http://www.opensolaris.org/os/licensing. * 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 2005 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ /* Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */ /* All Rights Reserved */ /* * Implements the main body of the "getdgrp" command. */ #include <sys/types.h> #include <stdio.h> #include <errno.h> #include <stdlib.h> #include <string.h> #include <devmgmt.h> #include <devtab.h> #include <fmtmsg.h> /* * Local Definitions * TRUE Boolean TRUE value * FALSE Boolean FALSE value * NULL Null address */ #ifndef TRUE #define TRUE 1 #endif #ifndef FALSE #define FALSE 0 #endif /* * Exit codes: * EX_OK All's well that ends well * EX_ERROR Some other error occurred * EX_DTAB Device table couldn't be opened * EX_DGRP Device-group table couldn't be open. */ #define EX_OK 0 #define EX_ERROR 1 #define EX_DTAB 2 #define EX_DGRP 2 /* * Messages: * M_USAGE Command usage error * M_ERROR Some unexpected error * M_DEVTAB Device table couldn't be opened * M_DGROUP Device-group table couldn't be opened */ #define M_USAGE "usage: getdgrp [-ael] [criterion [...]] [dgroup [...]]" #define M_ERROR "Internal error, errno=%d" #define M_DEVTAB "Cannot open the device table: %s" #define M_DGROUP "Cannot open the device-group table: %s" /* * Internal References * buildcriterialist() Builds a list of the criteria on the * command line * buildgrouplist() Builds a list of the device-groups mentioned * on the command line */ static char **buildcriterialist(); /* Builds criteria list from command line */ static char **builddgrouplist(); /* Builds dgroup list from command line */ /* * Macros * stdmsg(r,l,s,t) Generate a standard message * r Recoverability flag * l Standard label * s Severity * t Text * isacriterion(p) Returns TRUE if *p is a criterion, FALSE otherwise */ #define stdmsg(r,l,s,t) (void) fmtmsg(MM_PRINT|MM_UTIL|r,l,s,t,MM_NULLACT,MM_NULLTAG) #define isacriterion(p) (strchr(*arglist,'=')||strchr(*arglist,':')) /* * Static Variables * lbl Buffer for standard message label * txt Buffer for standard message text */ static char lbl[MM_MXLABELLN+1]; static char txt[MM_MXTXTLN+1]; /* * getdgrp [-ael] [criterion [...]] [dgroup [...]] * * This function gets the device groups that contain as members devices * that match the given criteria. * * Options: * -a A device must meet all criteria before the device-group in * which it is a member can be selected for inclusion in the * generated list. If this option is missing, a device must * meet at least one criterion before it's group can be * selected. This option has no affect if there are no criterion * on the command-line. * -e The list of device groups specifies groups to exclude from * the generated list. If this option is omitted, the list * of groups is the set of groups that can be selected. This * option has no effect if there are no device-groups on the * command-line. * -l List all device groups, even those that have no valid * members (this option has no effect if criterion are specified * * Arguments: * criterion A device criterion of the form <attr><op><val> where * <attr> is the name of an attribute, <op> is "=", "!=", * ":", or "!:" for "is equal to", "is not equal to", * "is defined," or "is not defined." <val> is the value * that the attribute must be equal to or not equal to. * (<val> must be "*" if <op> is ":" or "!:"). * dgroup A device group that is to be exclude selected for the * generated list or excluded from the the generated * list. * * Exit values: * 0 Success * 1 Usage or an internal error * 2 The device table or the device-group table could not be * opened for reading */ int main(int argc, char **argv) { /* * Automatic data */ char **arglist; /* List of arguments (subset of argv) */ char **criterialist; /* List of criteria */ char **dgrouplist; /* List of device groups to search or ignore */ char **fitgrouplist; /* List of device groups that fit criteria */ char *cmdname; /* Simple command name */ char *dgroup; /* Pointer to device group name in list */ char *filename; /* Pointer to filename in "error" */ int exitcode; /* Value to return to the caller */ int sev; /* Message severity */ int optchar; /* Option character (returned by getopt()) */ int andflag; /* TRUE if anding criteria, FALSE if or'ed */ int excludeflag; /* TRUE if the dgroups list those to exclude */ int allflag; /* TRUE if all device grps are to be displayed */ int options; /* Options to pass to getdgrp() */ int usageerr; /* TRUE if syntax error */ /* Build the message label from the (simple) command name */ if (cmdname = strrchr(argv[0], '/')) cmdname++; else cmdname = argv[0]; (void) strlcat(strcpy(lbl, "UX:"), cmdname, sizeof(lbl)); /* Only write the text-component of messages (this goes away in SVR4.1) */ (void) putenv("MSGVERB=text"); /* * Parse the command line: * - Options * - Selection criteria * - Device groups to include or exclude */ /* * Extract options from the command line */ /* Initializations */ andflag = FALSE; /* No -a */ excludeflag = FALSE; /* No -e */ allflag = FALSE; /* No -l */ usageerr = FALSE; /* No errors yet */ /* * Loop until all of the command line options have been parced */ opterr = FALSE; /* Don't let getopt() write messages */ while ((optchar = getopt(argc, argv, "ael")) != EOF) switch (optchar) { /* -a List device groups that fit all of the criteria listed */ case 'a': if (andflag) usageerr = TRUE; else andflag = TRUE; break; /* -e Exclude those device groups mentioned on the command line */ case 'e': if (excludeflag) usageerr = TRUE; else excludeflag = TRUE; break; /* -l List all device groups (if no criteria is specified) */ case 'l': if (allflag) usageerr = TRUE; else allflag = TRUE; break; /* Default case -- command usage error */ case '?': default: usageerr = TRUE; break; } /* If there is a usage error, write an appropriate message and exit */ if (usageerr) { stdmsg(MM_NRECOV, lbl, MM_ERROR, M_USAGE); exit(EX_ERROR); } /* Open the device file (if there's one to be opened) */ if (!_opendevtab("r")) { if (filename = _devtabpath()) { (void) snprintf(txt, sizeof(txt), M_DEVTAB, filename); exitcode = EX_DTAB; sev = MM_ERROR; } else { (void) sprintf(txt, M_ERROR, errno); exitcode = EX_ERROR; sev = MM_HALT; } stdmsg(MM_NRECOV, lbl, sev, txt); exit(exitcode); } /* Open the device file (if there's one to be opened) */ if (!_opendgrptab("r")) { if (filename = _dgrptabpath()) { (void) snprintf(txt, sizeof(txt), M_DGROUP, filename); exitcode = EX_DGRP; sev = MM_ERROR; } else { (void) sprintf(txt, M_ERROR, errno); exitcode = EX_ERROR; sev = MM_HALT; } stdmsg(MM_NRECOV, lbl, sev, txt); exit(exitcode); } /* Build the list of criteria and device groups */ arglist = argv + optind; criterialist = buildcriterialist(arglist); dgrouplist = builddgrouplist(arglist); options = (excludeflag ? DTAB_EXCLUDEFLAG : 0) | (andflag ? DTAB_ANDCRITERIA : 0) | (allflag ? DTAB_LISTALL : 0) ; /* * Get the list of device groups that meets the criteria requested. * If we got a list (that might be empty), write that list to the * standard output file (stdout). */ exitcode = EX_OK; if (!(fitgrouplist = getdgrp(dgrouplist, criterialist, options))) { exitcode = EX_ERROR; } else for (dgroup = *fitgrouplist++ ; dgroup ; dgroup = *fitgrouplist++) (void) puts(dgroup); /* Finished */ return(exitcode); } /* * char **buildcriterialist(arglist) * char **arglist * * This function builds a list of criteria descriptions from the * list of arguments given. The list returned is in malloc()ed * space. * * Arguments: * arglist The address of the first element in the list * of arguments (possibly) containing criterion * * Returns: char ** * A pointer to the first element in the list of criterion. * If there was a problem, the function returns (char **) NULL. * If there are no criteria in the list, the function returns * an empty list. */ static char ** buildcriterialist(arglist) char **arglist; /* Pointer to the list of argument pointers */ { /* * Automatic data */ char **pp; /* Pointer to a criteria */ void *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 ('=') */ pp = arglist; ncriteria = 1; while (*pp && (strchr(*pp, '=') || strchr(*pp, ':'))) { ncriteria++; pp++; } /* Allocate space for the list of criteria pointers */ if (allocbuf = malloc(ncriteria*sizeof(char **))) { /* Build the list of criteria arguments */ pp = (char **) allocbuf; while ((*arglist != (char *) NULL) && isacriterion(*arglist)) *pp++ = *arglist++; *pp = (char *) NULL; } return ((char **) allocbuf); } /* * char **builddgrouplist(arglist) * char **arglist * * This function returns a pointer to the first element in a list of * device-groups (i.e. not criteria) specified in the list of arguments * whose first element is pointed to by <arglist>. * * Arguments: * arglist The address of the first element in the list of * arguments to be searched for non-criteria * * Returns: char ** * The address of the first item in the list of arguments that are * not criteria. If none, the function returns a pointer to a * null list. * * Note: * - The current implementation returns a pointer to an element in * <arglist>. */ static char ** builddgrouplist(arglist) char **arglist; /* First item in the list of arguments */ { /* * 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 * group in the list of device groups (if any). */ while (*arglist && isacriterion(*arglist)) arglist++; /* Return a pointer to the argument list. */ return(arglist); }
