Differential D4277 Diff 10503 lib/libcasper/libcasper/libcasper.h

Changeset View

Standalone View

lib/libcasper/libcasper/libcasper.h

This file was added.

				/*-
				* Copyright (c) 2012-2013 The FreeBSD Foundation
				* Copyright (c) 2015 Mariusz Zaborski <oshogbo@FreeBSD.org>
				* All rights reserved.
				*
				* This software was developed by Pawel Jakub Dawidek under sponsorship from
				* the FreeBSD Foundation.
				*
				* Redistribution and use in source and binary forms, with or without
				* modification, are permitted provided that the following conditions
				* are met:
				* 1. Redistributions of source code must retain the above copyright
				* notice, this list of conditions and the following disclaimer.
				* 2. Redistributions in binary form must reproduce the above copyright
				* notice, this list of conditions and the following disclaimer in the
				* documentation and/or other materials provided with the distribution.
				*
				* THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
				* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
				* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
				* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
				* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
				* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
				* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
				* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
				* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
				* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
				* SUCH DAMAGE.
				*
				* $FreeBSD$
				*/

				#ifndef _LIBCASPER_H_
				#define _LIBCASPER_H_

				#include <sys/types.h>

				#ifndef _NVLIST_T_DECLARED
				#define _NVLIST_T_DECLARED
				struct nvlist;

				typedef struct nvlist nvlist_t;
				#endif

				#ifndef _CAP_CHANNEL_T_DECLARED
				#define _CAP_CHANNEL_T_DECLARED
				struct cap_channel;

				typedef struct cap_channel cap_channel_t;
				#endif

				/*
				* The functions opens unrestricted communication channel to Casper.
				*/
				cap_channel_t *cap_init(void);

				/*
				* The functions to communicate with service.
				*/
				cap_channel_t cap_service_open(const cap_channel_t chan, const char *name);
				int cap_service_limit(const cap_channel_t *chan,
				const char * const *names, size_t nnames);

				/*
				* The function creates cap_channel_t based on the given socket.
				*/
				cap_channel_t *cap_wrap(int sock);

				/*
				* The function returns communication socket and frees cap_channel_t.
				*/
				int cap_unwrap(cap_channel_t *chan);

				/*
				* The function clones the given capability.
				*/
				cap_channel_t cap_clone(const cap_channel_t chan);

				/*
				* The function closes the given capability.
				*/
				void cap_close(cap_channel_t *chan);

				/*
				* The function returns socket descriptor associated with the given
				* cap_channel_t for use with select(2)/kqueue(2)/etc.
				*/
				int cap_sock(const cap_channel_t *chan);

				/*
				* The function limits the given capability.
				* It always destroys 'limits' on return.
				*/
				int cap_limit_set(const cap_channel_t chan, nvlist_t limits);

				/*
				* The function returns current limits of the given capability.
				*/
				int cap_limit_get(const cap_channel_t chan, nvlist_t *limitsp);

				/*
				* Function sends nvlist over the given capability.
				*/
				int cap_send_nvlist(const cap_channel_t chan, const nvlist_t nvl);
				/*
				* Function receives nvlist over the given capability.
				*/
				nvlist_t cap_recv_nvlist(const cap_channel_t chan, int flags);
				/*
				* Function sends the given nvlist, destroys it and receives new nvlist in
				* response over the given capability.
				*/
				nvlist_t cap_xfer_nvlist(const cap_channel_t chan, nvlist_t *nvl, int flags);

				#endif /* !_LIBCASPER_H_ */