/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (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 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _GROUP_H
#define _GROUP_H
/*
* Group Abstraction
*/
#ifdef __cplusplus
extern "C" {
#endif
/*
* group structure
*/
typedef struct group {
} group_t;
/*
* Return the number of elements in the group
*/
/*
* Access the element at the specified group index
*/
/*
* Group creation / destruction
*/
void group_create(group_t *);
void group_destroy(group_t *);
/*
* Expand a group's holding capacity
*/
/*
* Group element iteration
*/
void group_iter_init(group_iter_t *);
/*
* Add / remove an element (or elements) from the group
*/
int group_remove(group_t *, void *, int);
void group_empty(group_t *);
/*
* Add / remove / access an element at a specified index.
* The group must already have sufficient capacity to hold
* an element at the specified index.
*/
/*
* Search for an element in a group.
* Returns an index that may be used with the *_at()
* routines above to add or remove the element.
*/
/*
* Convert a group to a string with list of integers.
*
* The consecutive integer values are represented using x-y notation.
* The resulting string looks like "1,2-5,8"
*
* The convert argument is used to map group elements to integer IDs.
* The output buffer and its length are specfied in the arguments.
*/
#endif /* !_KERNEL && !_KMEMUSER */
#ifdef __cplusplus
}
#endif
#endif /* _GROUP_H */