Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * linux/ipc/util.h |
| 3 | * Copyright (C) 1999 Christoph Rohland |
| 4 | * |
| 5 | * ipc helper functions (c) 1999 Manfred Spraul <manfreds@colorfullife.com> |
| 6 | */ |
| 7 | |
| 8 | #ifndef _IPC_UTIL_H |
| 9 | #define _IPC_UTIL_H |
| 10 | |
| 11 | #define USHRT_MAX 0xffff |
| 12 | #define SEQ_MULTIPLIER (IPCMNI) |
| 13 | |
| 14 | void sem_init (void); |
| 15 | void msg_init (void); |
| 16 | void shm_init (void); |
| 17 | |
| 18 | struct ipc_id_ary { |
| 19 | int size; |
| 20 | struct kern_ipc_perm *p[0]; |
| 21 | }; |
| 22 | |
| 23 | struct ipc_ids { |
| 24 | int in_use; |
| 25 | int max_id; |
| 26 | unsigned short seq; |
| 27 | unsigned short seq_max; |
| 28 | struct semaphore sem; |
| 29 | struct ipc_id_ary nullentry; |
| 30 | struct ipc_id_ary* entries; |
| 31 | }; |
| 32 | |
Mike Waychison | ae78177 | 2005-09-06 15:17:09 -0700 | [diff] [blame] | 33 | struct seq_file; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 34 | void __init ipc_init_ids(struct ipc_ids* ids, int size); |
Mike Waychison | ae78177 | 2005-09-06 15:17:09 -0700 | [diff] [blame] | 35 | #ifdef CONFIG_PROC_FS |
| 36 | void __init ipc_init_proc_interface(const char *path, const char *header, |
| 37 | struct ipc_ids *ids, |
| 38 | int (*show)(struct seq_file *, void *)); |
| 39 | #else |
| 40 | #define ipc_init_proc_interface(path, header, ids, show) do {} while (0) |
| 41 | #endif |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 42 | |
| 43 | /* must be called with ids->sem acquired.*/ |
| 44 | int ipc_findkey(struct ipc_ids* ids, key_t key); |
| 45 | int ipc_addid(struct ipc_ids* ids, struct kern_ipc_perm* new, int size); |
| 46 | |
| 47 | /* must be called with both locks acquired. */ |
| 48 | struct kern_ipc_perm* ipc_rmid(struct ipc_ids* ids, int id); |
| 49 | |
| 50 | int ipcperms (struct kern_ipc_perm *ipcp, short flg); |
| 51 | |
| 52 | /* for rare, potentially huge allocations. |
| 53 | * both function can sleep |
| 54 | */ |
| 55 | void* ipc_alloc(int size); |
| 56 | void ipc_free(void* ptr, int size); |
| 57 | |
| 58 | /* |
| 59 | * For allocation that need to be freed by RCU. |
| 60 | * Objects are reference counted, they start with reference count 1. |
| 61 | * getref increases the refcount, the putref call that reduces the recount |
| 62 | * to 0 schedules the rcu destruction. Caller must guarantee locking. |
| 63 | */ |
| 64 | void* ipc_rcu_alloc(int size); |
| 65 | void ipc_rcu_getref(void *ptr); |
| 66 | void ipc_rcu_putref(void *ptr); |
| 67 | |
| 68 | struct kern_ipc_perm* ipc_get(struct ipc_ids* ids, int id); |
| 69 | struct kern_ipc_perm* ipc_lock(struct ipc_ids* ids, int id); |
| 70 | void ipc_lock_by_ptr(struct kern_ipc_perm *ipcp); |
| 71 | void ipc_unlock(struct kern_ipc_perm* perm); |
| 72 | int ipc_buildid(struct ipc_ids* ids, int id, int seq); |
| 73 | int ipc_checkid(struct ipc_ids* ids, struct kern_ipc_perm* ipcp, int uid); |
| 74 | |
| 75 | void kernel_to_ipc64_perm(struct kern_ipc_perm *in, struct ipc64_perm *out); |
| 76 | void ipc64_perm_to_ipc_perm(struct ipc64_perm *in, struct ipc_perm *out); |
| 77 | |
Chris Zankel | 813e678 | 2005-07-12 13:58:25 -0700 | [diff] [blame] | 78 | #if defined(__ia64__) || defined(__x86_64__) || defined(__hppa__) || defined(__XTENSA__) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 79 | /* On IA-64, we always use the "64-bit version" of the IPC structures. */ |
| 80 | # define ipc_parse_version(cmd) IPC_64 |
| 81 | #else |
| 82 | int ipc_parse_version (int *cmd); |
| 83 | #endif |
| 84 | |
| 85 | extern void free_msg(struct msg_msg *msg); |
| 86 | extern struct msg_msg *load_msg(const void __user *src, int len); |
| 87 | extern int store_msg(void __user *dest, struct msg_msg *msg, int len); |
| 88 | |
| 89 | #endif |