From: Ben Gras <ben@minix3.org>
Date: Tue, 20 Jun 2006 14:25:42 +0000 (+0000)
Subject: <minix/safecopies>
X-Git-Tag: v3.1.3~304
X-Git-Url: http://zhaoyanbai.com/repos/icons/debian/static/doxygen.log?a=commitdiff_plain;h=ed9be753845608822cb1d8ebb4e6faec197a8b88;p=minix.git

<minix/safecopies>
---

diff --git a/include/minix/safecopies.h b/include/minix/safecopies.h
new file mode 100644
index 000000000..3a79cffdc
--- /dev/null
+++ b/include/minix/safecopies.h
@@ -0,0 +1,68 @@
+
+#ifndef _MINIX_SAFECOPIES_H
+#define _MINIX_SAFECOPIES_H 1
+
+#include <minix/sys_config.h>
+#include <sys/types.h>
+#include <stdint.h>
+
+typedef int32_t cp_grant_id_t;
+
+typedef struct {
+	int cp_flags;	/* CPF_* below */
+	union {
+		struct {
+			/* CPF_DIRECT */
+			endpoint_t	cp_who_to;	/* grantee */
+			vir_bytes	cp_start;	/* memory */
+			size_t		cp_len;		/* size in bytes */
+			char		cp_reserved[8]; /* future use */
+		} cp_direct;
+		struct {
+			/* CPF_INDIRECT */
+			endpoint_t	cp_who_to;	/* grantee */
+			endpoint_t	cp_who_from;	/* previous granter */
+			cp_grant_id_t	cp_grant;	/* previous grant */
+			char		cp_reserved[8];/* future use */
+		} cp_indirect;
+		struct {
+			/* CPF_MAGIC */
+			endpoint_t	cp_who_from;	/* granter */
+			endpoint_t	cp_who_to;	/* grantee */
+			vir_bytes	cp_start;	/* memory */
+			size_t		cp_len;		/* size in bytes */
+			char		cp_reserved[8]; /* future use */
+		} cp_magic;
+	} cp_u;
+	char cp_reserved[8];				/* future use */
+} cp_grant_t;
+
+/* Invalid grant number. */
+#define GRANT_INVALID	-1
+#define GRANT_VALID(g)	((g) > GRANT_INVALID)
+
+/* Operations: any combination is ok. */
+#define CPF_READ	0x000001 /* Granted process may read. */
+#define CPF_WRITE	0x000002 /* Granted process may write. */
+
+/* Internal flags. */
+#define CPF_USED	0x000100 /* Grant slot in use. */
+#define CPF_DIRECT	0x000200 /* Grant from this process to another. */
+#define CPF_INDIRECT	0x000400 /* Grant from grant to another. */
+#define CPF_MAGIC	0x000800 /* Grant from any to any. */
+
+/* Prototypes for functions in libsys. */
+_PROTOTYPE( cp_grant_id_t cpf_grant_direct, (endpoint_t, vir_bytes, size_t, int));
+_PROTOTYPE( cp_grant_id_t cpf_grant_indirect, (endpoint_t, endpoint_t, cp_grant_id_t));
+_PROTOTYPE( cp_grant_id_t cpf_grant_magic, (endpoint_t, endpoint_t, vir_bytes, size_t, int));
+_PROTOTYPE( int cpf_revoke, (cp_grant_id_t grant_id));
+_PROTOTYPE( int cpf_preallocate, (cp_grant_t *, int));
+_PROTOTYPE( int cpf_lookup, (cp_grant_id_t g, endpoint_t *ep, endpoint_t *ep2));
+
+/* Set a process' grant table location and size (in-kernel only). */
+#define _K_SET_GRANT_TABLE(rp, ptr, entries)	\
+	priv(rp)->s_grant_table= (ptr);		\
+	priv(rp)->s_grant_entries= (entries);
+
+#endif	/* _MINIX_SAFECOPIES_H */
+