xref: /onnv-gate/usr/src/lib/libadm/common/listdgrp.c (revision 0:68f95e015346)
1*0Sstevel@tonic-gate /*
2*0Sstevel@tonic-gate  * CDDL HEADER START
3*0Sstevel@tonic-gate  *
4*0Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
5*0Sstevel@tonic-gate  * Common Development and Distribution License, Version 1.0 only
6*0Sstevel@tonic-gate  * (the "License").  You may not use this file except in compliance
7*0Sstevel@tonic-gate  * with the License.
8*0Sstevel@tonic-gate  *
9*0Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*0Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
11*0Sstevel@tonic-gate  * See the License for the specific language governing permissions
12*0Sstevel@tonic-gate  * and limitations under the License.
13*0Sstevel@tonic-gate  *
14*0Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
15*0Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*0Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
17*0Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
18*0Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
19*0Sstevel@tonic-gate  *
20*0Sstevel@tonic-gate  * CDDL HEADER END
21*0Sstevel@tonic-gate  */
22*0Sstevel@tonic-gate /*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
23*0Sstevel@tonic-gate /*	  All Rights Reserved  	*/
24*0Sstevel@tonic-gate 
25*0Sstevel@tonic-gate 
26*0Sstevel@tonic-gate /*
27*0Sstevel@tonic-gate  * Copyright (c) 1997, by Sun Microsystems, Inc.
28*0Sstevel@tonic-gate  * All rights reserved.
29*0Sstevel@tonic-gate  */
30*0Sstevel@tonic-gate 
31*0Sstevel@tonic-gate #pragma	ident	"%Z%%M%	%I%	%E% SMI"	/* SVr4.0 1.1 */
32*0Sstevel@tonic-gate /*LINTLIBRARY*/
33*0Sstevel@tonic-gate 
34*0Sstevel@tonic-gate /*
35*0Sstevel@tonic-gate  *  listdgrp.c
36*0Sstevel@tonic-gate  *
37*0Sstevel@tonic-gate  *  Contents:
38*0Sstevel@tonic-gate  *	listdgrp()	List devices that belong to a device group.
39*0Sstevel@tonic-gate  */
40*0Sstevel@tonic-gate 
41*0Sstevel@tonic-gate /*
42*0Sstevel@tonic-gate  * Header files referenced:
43*0Sstevel@tonic-gate  *	<sys/types.h>	System Data Types
44*0Sstevel@tonic-gate  *	<errno.h>	UNIX and C error definitions
45*0Sstevel@tonic-gate  *	<string.h>	String handling definitions
46*0Sstevel@tonic-gate  *	<devmgmt.h>	Device management definitions
47*0Sstevel@tonic-gate  *	"devtab.h"	Local device table definitions
48*0Sstevel@tonic-gate  */
49*0Sstevel@tonic-gate 
50*0Sstevel@tonic-gate #include	<sys/types.h>
51*0Sstevel@tonic-gate #include	<errno.h>
52*0Sstevel@tonic-gate #include	<string.h>
53*0Sstevel@tonic-gate #include	<stdlib.h>
54*0Sstevel@tonic-gate #include	<devmgmt.h>
55*0Sstevel@tonic-gate #include	"devtab.h"
56*0Sstevel@tonic-gate 
57*0Sstevel@tonic-gate /*
58*0Sstevel@tonic-gate  * Local definitions
59*0Sstevel@tonic-gate  */
60*0Sstevel@tonic-gate 
61*0Sstevel@tonic-gate 
62*0Sstevel@tonic-gate /*
63*0Sstevel@tonic-gate  *  Structure definitions:
64*0Sstevel@tonic-gate  */
65*0Sstevel@tonic-gate 
66*0Sstevel@tonic-gate /*
67*0Sstevel@tonic-gate  * Local functions referenced
68*0Sstevel@tonic-gate  */
69*0Sstevel@tonic-gate 
70*0Sstevel@tonic-gate /*
71*0Sstevel@tonic-gate  * Global Data
72*0Sstevel@tonic-gate  */
73*0Sstevel@tonic-gate 
74*0Sstevel@tonic-gate /*
75*0Sstevel@tonic-gate  * Static Data
76*0Sstevel@tonic-gate  */
77*0Sstevel@tonic-gate 
78*0Sstevel@tonic-gate /*
79*0Sstevel@tonic-gate  * char **listdgrp(dgroup)
80*0Sstevel@tonic-gate  *	char   *dgroup
81*0Sstevel@tonic-gate  *
82*0Sstevel@tonic-gate  *	List the members of a device group.
83*0Sstevel@tonic-gate  *
84*0Sstevel@tonic-gate  *  Arguments:
85*0Sstevel@tonic-gate  *	char *dgroup	The device group needed
86*0Sstevel@tonic-gate  *
87*0Sstevel@tonic-gate  *  Returns:  char **
88*0Sstevel@tonic-gate  *	A pointer to a list of pointers to char-strings containing
89*0Sstevel@tonic-gate  *	the members of the device group.
90*0Sstevel@tonic-gate  *
91*0Sstevel@tonic-gate  *  Notes:
92*0Sstevel@tonic-gate  *    -	malloc()ed space containing addresses
93*0Sstevel@tonic-gate  */
94*0Sstevel@tonic-gate 
95*0Sstevel@tonic-gate char  **
listdgrp(char * dgroup)96*0Sstevel@tonic-gate listdgrp(char *dgroup)	/* The device group to list */
97*0Sstevel@tonic-gate {
98*0Sstevel@tonic-gate 	/* Automatic data */
99*0Sstevel@tonic-gate 	struct dgrptabent	*dgrpent;	/* Device group description */
100*0Sstevel@tonic-gate 	struct member		*member;	/* Device group member */
101*0Sstevel@tonic-gate 	char			**listbuf;	/* Buffer allocated for addrs */
102*0Sstevel@tonic-gate 	char			**rtnval;	/* Value to return */
103*0Sstevel@tonic-gate 	char			**pp;		/* Running ptr through addrs */
104*0Sstevel@tonic-gate 	int			noerror;	/* Flag, TRUE if all's well */
105*0Sstevel@tonic-gate 	int			n;		/* Counter */
106*0Sstevel@tonic-gate 
107*0Sstevel@tonic-gate 
108*0Sstevel@tonic-gate 	/*
109*0Sstevel@tonic-gate 	 *  Initializations
110*0Sstevel@tonic-gate 	 */
111*0Sstevel@tonic-gate 
112*0Sstevel@tonic-gate 	/*
113*0Sstevel@tonic-gate 	 *  Get the record for this device group
114*0Sstevel@tonic-gate 	 */
115*0Sstevel@tonic-gate 
116*0Sstevel@tonic-gate 	if (dgrpent = _getdgrprec(dgroup)) {
117*0Sstevel@tonic-gate 
118*0Sstevel@tonic-gate 	    /*  Count the number of members in the device group  */
119*0Sstevel@tonic-gate 	    n = 1;
120*0Sstevel@tonic-gate 	    for (member = dgrpent->membership; member; member = member->next)
121*0Sstevel@tonic-gate 		n++;
122*0Sstevel@tonic-gate 
123*0Sstevel@tonic-gate 	    /*  Get space for the list to return  */
124*0Sstevel@tonic-gate 	    if (listbuf = malloc(n*sizeof (char **))) {
125*0Sstevel@tonic-gate 
126*0Sstevel@tonic-gate 		/*
127*0Sstevel@tonic-gate 		 *  For each member in the device group, add that device
128*0Sstevel@tonic-gate 		 *  name to the list of devices we're building
129*0Sstevel@tonic-gate 		 */
130*0Sstevel@tonic-gate 
131*0Sstevel@tonic-gate 		pp = listbuf;
132*0Sstevel@tonic-gate 		noerror = TRUE;
133*0Sstevel@tonic-gate 		for (member = dgrpent->membership; noerror && member;
134*0Sstevel@tonic-gate 		    member = member->next) {
135*0Sstevel@tonic-gate 
136*0Sstevel@tonic-gate 		    if (*pp = malloc(strlen(member->name)+1))
137*0Sstevel@tonic-gate 
138*0Sstevel@tonic-gate 			(void) strcpy(*pp++, member->name);
139*0Sstevel@tonic-gate 		    else noerror = FALSE;
140*0Sstevel@tonic-gate 		}
141*0Sstevel@tonic-gate 
142*0Sstevel@tonic-gate 
143*0Sstevel@tonic-gate 		/*
144*0Sstevel@tonic-gate 		 *  If there's no error, terminate the list we've built.
145*0Sstevel@tonic-gate 		 *  Otherwise, free the space allocated to the stuff we've built
146*0Sstevel@tonic-gate 		 */
147*0Sstevel@tonic-gate 
148*0Sstevel@tonic-gate 		if (noerror) {
149*0Sstevel@tonic-gate 		    *pp = NULL;
150*0Sstevel@tonic-gate 		    rtnval = listbuf;
151*0Sstevel@tonic-gate 		} else {
152*0Sstevel@tonic-gate 		    /*  Some error occurred.  Clean up allocations  */
153*0Sstevel@tonic-gate 		    for (pp = listbuf; *pp; pp++) free(*pp);
154*0Sstevel@tonic-gate 		    free(listbuf);
155*0Sstevel@tonic-gate 		    rtnval = NULL;
156*0Sstevel@tonic-gate 		}
157*0Sstevel@tonic-gate 
158*0Sstevel@tonic-gate 	    }  /* if (malloc()) */
159*0Sstevel@tonic-gate 
160*0Sstevel@tonic-gate 	    /*  Free space alloced to the device group entry  */
161*0Sstevel@tonic-gate 	    _freedgrptabent(dgrpent);
162*0Sstevel@tonic-gate 
163*0Sstevel@tonic-gate 	}  /* if (_getdgrprec()) */
164*0Sstevel@tonic-gate 	else rtnval = NULL;
165*0Sstevel@tonic-gate 
166*0Sstevel@tonic-gate 
167*0Sstevel@tonic-gate 	/*  Finished -- wasn't that simple?  */
168*0Sstevel@tonic-gate 	return (rtnval);
169*0Sstevel@tonic-gate }
170