7ec9fc9cbc071f9f7d7d89264e84ee0ac916da3a
[linux-2.6.git] / security / tomoyo / realpath.h
1 /*
2  * security/tomoyo/realpath.h
3  *
4  * Get the canonicalized absolute pathnames. The basis for TOMOYO.
5  *
6  * Copyright (C) 2005-2009  NTT DATA CORPORATION
7  *
8  * Version: 2.2.0-pre   2009/02/01
9  *
10  */
11
12 #ifndef _SECURITY_TOMOYO_REALPATH_H
13 #define _SECURITY_TOMOYO_REALPATH_H
14
15 struct path;
16 struct tomoyo_path_info;
17 struct tomoyo_io_buffer;
18
19 /* Convert binary string to ascii string. */
20 int tomoyo_encode(char *buffer, int buflen, const char *str);
21
22 /* Returns realpath(3) of the given pathname but ignores chroot'ed root. */
23 int tomoyo_realpath_from_path2(struct path *path, char *newname,
24                                int newname_len);
25
26 /*
27  * Returns realpath(3) of the given pathname but ignores chroot'ed root.
28  * These functions use tomoyo_alloc(), so the caller must call tomoyo_free()
29  * if these functions didn't return NULL.
30  */
31 char *tomoyo_realpath(const char *pathname);
32 /*
33  * Same with tomoyo_realpath() except that it doesn't follow the final symlink.
34  */
35 char *tomoyo_realpath_nofollow(const char *pathname);
36 /* Same with tomoyo_realpath() except that the pathname is already solved. */
37 char *tomoyo_realpath_from_path(struct path *path);
38
39 /*
40  * Allocate memory for ACL entry.
41  * The RAM is chunked, so NEVER try to kfree() the returned pointer.
42  */
43 void *tomoyo_alloc_element(const unsigned int size);
44
45 /*
46  * Keep the given name on the RAM.
47  * The RAM is shared, so NEVER try to modify or kfree() the returned name.
48  */
49 const struct tomoyo_path_info *tomoyo_save_name(const char *name);
50
51 /* Allocate memory for temporary use (e.g. permission checks). */
52 void *tomoyo_alloc(const size_t size);
53
54 /* Free memory allocated by tomoyo_alloc(). */
55 void tomoyo_free(const void *p);
56
57 /* Check for memory usage. */
58 int tomoyo_read_memory_counter(struct tomoyo_io_buffer *head);
59
60 /* Set memory quota. */
61 int tomoyo_write_memory_quota(struct tomoyo_io_buffer *head);
62
63 /* Initialize realpath related code. */
64 void __init tomoyo_realpath_init(void);
65
66 #endif /* !defined(_SECURITY_TOMOYO_REALPATH_H) */