kidmap.h revision c5c4113dfcabb1eed3d4bdf7609de5170027a794
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * CDDL HEADER START
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * The contents of this file are subject to the terms of the
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Common Development and Distribution License (the "License").
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * You may not use this file except in compliance with the License.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * See the License for the specific language governing permissions
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * and limitations under the License.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * When distributing Covered Code, include this CDDL HEADER in each
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * If applicable, add the following below this CDDL HEADER, with the
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * fields enclosed by brackets "[]" replaced with your own identifying
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * information: Portions Copyright [yyyy] [name of copyright owner]
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * CDDL HEADER END
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Use is subject to license terms.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Windows to Solaris Identity Mapping kernel API
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * This header defines an API to map Windows SIDs to
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Solaris UID and GIDs and versa visa.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw#pragma ident "%Z%%M% %I% %E% SMI"
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwextern "C" {
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw/* Opaque get handle */
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw/* Return status */
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * In all the routines a Windows SID is handled as a
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * string SID prefix plus a RID. For example
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * S-1-5-5-12-34-568 will be passed as SID prefix
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * S-1-5-5-12-34 and RID 568
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Certain routines returns pointers to a SID prefix string.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * These strings are stored internally and should not be modified
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * or freed.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * The following routines are simple get ID mapping routines.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_getuidbysid(const char *sid_prefix, uint32_t rid, uid_t *uid);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_getgidbysid(const char *sid_prefix, uint32_t rid, gid_t *gid);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_getpidbysid(const char *sid_prefix, uint32_t rid, uid_t *pid,
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_getsidbyuid(uid_t uid, const char **sid_prefix, uint32_t *rid);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_getsidbygid(gid_t gid, const char **sid_prefix, uint32_t *rid);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * The following routines provide a batch interface for mapping IDs.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Create a batch "get mapping" handle for batch mappings.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * These routines queue the request to the "get mapping" handle
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_batch_getsidbyuid(idmap_get_handle_t *get_handle, uid_t uid,
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw const char **sid_prefix, uint32_t *rid, idmap_stat *stat);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwkidmap_batch_getsidbygid(idmap_get_handle_t *get_handle, gid_t gid,
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw const char **sid_prefix, uint32_t *rid, idmap_stat *stat);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Process the queued "get mapping" requests. The results (i.e.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * status and identity) will be available in the data areas
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * provided by individual requests.
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Destroy the "get mapping" handle
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Functions that do the hard part of door registration/unregistration
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * for the idmap_reg()/idmap_unreg() syscalls
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * Functions needed by allocids() to ensure only the daemon that owns
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw * the door gets ephemeral IDS
c5c4113dfcabb1eed3d4bdf7609de5170027a794nwvoid idmap_get_door(idmap_reg_t **state, door_handle_t *dh);
c5c4113dfcabb1eed3d4bdf7609de5170027a794nw#endif /* _SYS_KIDMAP_H */