diff options
Diffstat (limited to 'include/libcgroup.h')
-rw-r--r-- | include/libcgroup.h | 457 |
1 files changed, 9 insertions, 448 deletions
diff --git a/include/libcgroup.h b/include/libcgroup.h index b7d997b..27812c5 100644 --- a/include/libcgroup.h +++ b/include/libcgroup.h @@ -13,453 +13,14 @@ * */ -#ifndef _LIBCG_H -#define _LIBCG_H +#ifndef _LIBCGROUP_H +#define _LIBCGROUP_H -#include <features.h> +#include <libcgroup/error.h> +#include <libcgroup/init.h> +#include <libcgroup/iterators.h> +#include <libcgroup/groups.h> +#include <libcgroup/tasks.h> +#include <libcgroup/config.h> -__BEGIN_DECLS - -#include <grp.h> -#include <stdbool.h> -#include <stdio.h> -#include <sys/types.h> -#include <linux/cn_proc.h> - -/* - * NOTE: Wide characters are not supported at the moment. Wide character support - * would require us to use a scanner/parser that can parse beyond ASCII - */ - -/* Flags for cgroup_change_cgroup_uid_gid() */ -enum cgflags { - CGFLAG_USECACHE = 0x01, -}; - -enum { - ECGROUPNOTCOMPILED=50000, - ECGROUPNOTMOUNTED, - ECGROUPNOTEXIST, - ECGROUPNOTCREATED, - ECGROUPSUBSYSNOTMOUNTED, - ECGROUPNOTOWNER, - ECGROUPMULTIMOUNTED,/* Controllers bound to different mount points */ - ECGROUPNOTALLOWED, /* This is the stock error. Default error. */ - ECGMAXVALUESEXCEEDED, - ECGCONTROLLEREXISTS, - ECGVALUEEXISTS, - ECGINVAL, - ECGCONTROLLERCREATEFAILED, - ECGFAIL, - ECGROUPNOTINITIALIZED, - ECGROUPVALUENOTEXIST, - /* Represents error coming from other libraries like glibc. libcgroup - * users need to check errno upon encoutering ECGOTHER. - */ - ECGOTHER, /* OS error, see errno */ - ECGROUPNOTEQUAL, - ECGCONTROLLERNOTEQUAL, - ECGROUPPARSEFAIL, /* Failed to parse rules configuration file. */ - ECGROUPNORULES, /* Rules list does not exist. */ - ECGMOUNTFAIL, - ECGSENTINEL, /* Please insert further error codes above this */ - ECGEOF, /* End of file, iterator */ - ECGCONFIGPARSEFAIL,/* Failed to parse config file (cgconfig.conf). */ - ECGNAMESPACEPATHS, - ECGNAMESPACECONTROLLER, - ECGMOUNTNAMESPACE, -}; - -#define ECGRULESPARSEFAIL ECGROUPPARSEFAIL - -/* - * Don't use CGROUP_WALK_TYPE_FILE right now. It is added here for - * later refactoring and better implementation. Most users *should* - * use CGROUP_WALK_TYPE_PRE_DIR. - */ -enum cgroup_walk_type { - CGROUP_WALK_TYPE_PRE_DIR = 0x1, /* Pre Order Directory */ - CGROUP_WALK_TYPE_POST_DIR = 0x2, /* Post Order Directory */ -}; - -enum cgroup_file_type { - CGROUP_FILE_TYPE_FILE, /* File */ - CGROUP_FILE_TYPE_DIR, /* Directory */ - CGROUP_FILE_TYPE_OTHER, /* Directory */ -}; - -enum cgroup_daemon_type { - CGROUP_DAEMON_UNCHANGE_CHILDREN = 0x1, -}; - -/** - * Flags for cgroup_delete_cgroup_ext - */ -enum cgroup_delete_flag { - /** - * Ignore errors caused by migration of tasks to parent group. - */ - CGFLAG_DELETE_IGNORE_MIGRATION = 1, - - /** - * Recursively delete all child groups. - */ - CGFLAG_DELETE_RECURSIVE = 2, -}; - -struct cgroup_file_info { - enum cgroup_file_type type; - const char *path; - const char *parent; - const char *full_path; - short depth; -}; - -#define CG_VALUE_MAX 100 -struct cgroup_stat { - char name[FILENAME_MAX]; - char value[CG_VALUE_MAX]; -}; - -struct cgroup_mount_point { - char name[FILENAME_MAX]; - char path[FILENAME_MAX]; -}; - -/* - * Detailed information about available controller. - */ - -struct controller_data { -/** Controller name. */ - char name[FILENAME_MAX]; -/** - * Hierarchy ID. Controllers with the same hierarchy ID - * are mounted together as one hierarchy. Controllers with - * ID 0 are not currently used. - */ - int hierarchy; -/** Number of groups. */ - int num_cgroups; -/** Enabled flag */ - int enabled; -}; - -/* Functions and structures that can be used by the application*/ -struct cgroup; -struct cgroup_controller; - -int cgroup_init(void); -int cgroup_attach_task(struct cgroup *cgroup); -int cgroup_modify_cgroup(struct cgroup *cgroup); -int cgroup_create_cgroup(struct cgroup *cgroup, int ignore_ownership); -int cgroup_delete_cgroup(struct cgroup *cgroup, int ignore_migration); -int cgroup_attach_task_pid(struct cgroup *cgroup, pid_t tid); -int cgroup_get_cgroup(struct cgroup *cgroup); -int cgroup_create_cgroup_from_parent(struct cgroup *cgroup, int ignore_ownership); -int cgroup_copy_cgroup(struct cgroup *dst, struct cgroup *src); - -/** - * Delete control group. - * All tasks are automatically moved to parent group. - * If CGFLAG_DELETE_IGNORE_MIGRATION flag is used, the errors that occurred - * during the task movement are ignored. - * CGFLAG_DELETE_RECURSIVE flag specifies that all subgroups should be removed - * too. If root group is being removed with this flag specified, all subgroups - * are removed but the root group itself is left undeleted. - * - * @param cgroup Group to delete. - * @param flags Combination of CGFLAG_DELETE_* flags, which indicate what and - * how to delete. - */ -int cgroup_delete_cgroup_ext(struct cgroup *cgroup, int flags); - -/** - * Changes the cgroup of a program based on the rules in the config file. - * If a rule exists for the given UID, GID or PROCESS NAME, then the given - * PID is placed into the correct group. By default, this function parses - * the configuration file each time it is called. - * - * The flags can alter the behavior of this function: - * CGFLAG_USECACHE: Use cached rules instead of parsing the config file - * - * This function may NOT be thread safe. - * @param uid The UID to match - * @param gid The GID to match - * @param procname The PROCESS NAME to match - * @param pid The PID of the process to move - * @param flags Bit flags to change the behavior, as defined above - * @return 0 on success, > 0 on error - * TODO: Determine thread-safeness and fix of not safe. - */ -int cgroup_change_cgroup_flags(const uid_t uid, const gid_t gid, - char *procname, const pid_t pid, const int flags); - -/** - * Changes the cgroup of a program based on the rules in the config file. If a - * rule exists for the given UID or GID, then the given PID is placed into the - * correct group. By default, this function parses the configuration file each - * time it is called. - * - * The flags can alter the behavior of this function: - * CGFLAG_USECACHE: Use cached rules instead of parsing the config file - * - * This function may NOT be thread safe. - * @param uid The UID to match - * @param gid The GID to match - * @param pid The PID of the process to move - * @param flags Bit flags to change the behavior, as defined above - * @return 0 on success, > 0 on error - * TODO: Determine thread-safeness and fix if not safe. - */ -int cgroup_change_cgroup_uid_gid_flags(const uid_t uid, const gid_t gid, - const pid_t pid, const int flags); - -/** - * Provides backwards-compatibility with older versions of the API. This - * function is deprecated, and cgroup_change_cgroup_uid_gid_flags() should be - * used instead. In fact, this function simply calls the newer one with flags - * set to 0 (none). - * @param uid The UID to match - * @param gid The GID to match - * @param pid The PID of the process to move - * @return 0 on success, > 0 on error - * - */ -int cgroup_change_cgroup_uid_gid(uid_t uid, gid_t gid, pid_t pid); - -/** - * Changes the cgroup of a program based on the path provided. In this case, - * the user must already know into which cgroup the task should be placed and - * no rules will be parsed. - * - * returns 0 on success. - */ -int cgroup_change_cgroup_path(char *path, pid_t pid, char *controllers[]); - -/** - * Print the cached rules table. This function should be called only after - * first calling cgroup_parse_config(), but it will work with an empty rule - * list. - * @param fp The file stream to print to - */ -void cgroup_print_rules_config(FILE *fp); - -/** - * Reloads the rules list, using the given configuration file. This function - * is probably NOT thread safe (calls cgroup_parse_rules_config()). - * @return 0 on success, > 0 on failure - */ -int cgroup_reload_cached_rules(void); - -/** - * Initializes the rules cache. - * @return 0 on success, > 0 on failure - */ -int cgroup_init_rules_cache(void); - -/** - * Get the current cgroup path where the task specified by pid_t pid - * has been classified - */ -int cgroup_get_current_controller_path(pid_t pid, const char *controller, - char **current_path); -/** - * Return error corresponding to @code in human readable format. - * @code: error code for which the corresponding error string is to be - * returned - */ -const char *cgroup_strerror(int code); - -/** - * Return last errno, which caused ECGOTHER error. - */ -int cgroup_get_last_errno(); - -/** - * Walk through the directory tree for the specified controller. - * @controller: Name of the controller, for which we want to walk - * the directory tree - * @base_path: Begin walking from this path - * @depth: The maximum depth to which the function should walk, 0 - * implies all the way down - * @handle: Handle to be used during iteration - * @info: info filled and returned about directory information - */ -int cgroup_walk_tree_begin(char *controller, char *base_path, const int depth, - void **handle, struct cgroup_file_info *info, - int *base_level); -/** - * Get the next element during the walk - * @depth: The maximum depth to which the function should walk, 0 - * implies all the way down - * @handle: Handle to be used during iteration - * @info: info filled and returned about directory information - * - * Returns ECGEOF when we are done walking through the nodes. - */ -int cgroup_walk_tree_next(const int depth, void **handle, - struct cgroup_file_info *info, int base_level); -int cgroup_walk_tree_end(void **handle); - -/** - * This API is used to set the flags for walk_tree API. Currently availble - * flags are - * - * CGROUP_WALK_TYPE_PRE_DIR - * CGROUP_WALK_TYPE_POST_DIR - * - */ -int cgroup_walk_tree_set_flags(void **handle, int flags); - -/** - * Read the statistics values for the specified controller - * @controller: Name of the controller for which stats are requested. - * @path: cgroup path. - * @handle: Handle to be used during iteration. - * @stat: Stats values will be filled and returned here. - */ -int cgroup_read_stats_begin(char *controller, char *path, void **handle, - struct cgroup_stat *stat); - -/** - * Read the next stat value. - * @handle: Handle to be used during iteration. - * @stat: Stats values will be filled and returned here. - */ -int cgroup_read_stats_next(void **handle, struct cgroup_stat *stat); - -int cgroup_read_stats_end(void **handle); - -/** - * Read the tasks file to get the list of tasks in a cgroup - * @cgroup: Name of the cgroup - * @controller: Name of the cgroup subsystem - * @handle: Handle to be used in the iteration - * @pid: The pid read from the tasks file. Will be filled in by the API - */ -int cgroup_get_task_begin(char *cgroup, char *controller, void **handle, - pid_t *pid); - -/** - * Register the unchanged process to a cgrulesengd daemon. - * If the daemon does not work, this function returns 0 as success. - * @param pid: The process id - * @param flags Bit flags to change the behavior, as defined above - * @return 0 on success, > 0 on error. - */ -int cgroup_register_unchanged_process(pid_t pid, int flags); - -/** - * Read the next task value - * @handle: The handle used for iterating - * @pid: The variable where the value will be stored - * - * return ECGEOF when the iterator finishes getting the list of tasks. - */ -int cgroup_get_task_next(void **handle, pid_t *pid); -int cgroup_get_task_end(void **handle); - -/** - * Read the mount table to give a list where each controller is - * mounted - * @handle: Handle to be used for iteration. - * @name: The variable where the name is stored. Should be freed by caller. - * @path: Te variable where the path to the controller is stored. Should be - * freed by the caller. - */ -int cgroup_get_controller_begin(void **handle, struct cgroup_mount_point *info); -/* - * While walking through the mount table, the controllers will be - * returned in order of their mount points. - */ -int cgroup_get_controller_next(void **handle, struct cgroup_mount_point *info); -int cgroup_get_controller_end(void **handle); - -/** - * Read the list of controllers from /proc/cgroups (not mounted included) - * @param handle: Handle to be used for iteration. - * @param info: The structure which contains all controller data - */ -int cgroup_get_all_controller_begin(void **handle, - struct controller_data *info); -/* - * While walking through the mount table, the controllers will be - * returned in the same order as is in /proc/cgroups file - */ -int cgroup_get_all_controller_next(void **handle, struct controller_data *info); -int cgroup_get_all_controller_end(void **handle); - -/* - * Reads the mount to table to give the mount point of a controller - * @controller: Name of the controller - * @mount_point: The string where the mount point is stored. Please note, - * the caller must free mount_point. - */ -int cgroup_get_subsys_mount_point(char *controller, char **mount_point); - -/* The wrappers for filling libcg structures */ - -struct cgroup *cgroup_new_cgroup(const char *name); -struct cgroup_controller *cgroup_add_controller(struct cgroup *cgroup, - const char *name); -void cgroup_free(struct cgroup **cgroup); -void cgroup_free_controllers(struct cgroup *cgroup); -int cgroup_add_value_string(struct cgroup_controller *controller, - const char *name, const char *value); -int cgroup_add_value_int64(struct cgroup_controller *controller, - const char *name, int64_t value); -int cgroup_add_value_uint64(struct cgroup_controller *controller, - const char *name, u_int64_t value); -int cgroup_add_value_bool(struct cgroup_controller *controller, - const char *name, bool value); -int cgroup_compare_cgroup(struct cgroup *cgroup_a, struct cgroup *cgroup_b); -int cgroup_compare_controllers(struct cgroup_controller *cgca, - struct cgroup_controller *cgcb); -int cgroup_set_uid_gid(struct cgroup *cgroup, uid_t tasks_uid, gid_t tasks_gid, - uid_t control_uid, gid_t control_gid); -int cgroup_get_uid_gid(struct cgroup *cgroup, uid_t *tasks_uid, - gid_t *tasks_gid, uid_t *control_uid, gid_t *control_gid); -int cgroup_get_value_string(struct cgroup_controller *controller, - const char *name, char **value); -int cgroup_set_value_string(struct cgroup_controller *controller, - const char *name, const char *value); -int cgroup_get_value_int64(struct cgroup_controller *controller, - const char *name, int64_t *value); -int cgroup_set_value_int64(struct cgroup_controller *controller, - const char *name, int64_t value); -int cgroup_get_value_uint64(struct cgroup_controller *controller, - const char *name, u_int64_t *value); -int cgroup_set_value_uint64(struct cgroup_controller *controller, - const char *name, u_int64_t value); -int cgroup_get_value_bool(struct cgroup_controller *controller, - const char *name, bool *value); -int cgroup_set_value_bool(struct cgroup_controller *controller, - const char *name, bool value); -struct cgroup_controller *cgroup_get_controller(struct cgroup *cgroup, - const char *name); - -/** - * Return the number of variables for the specified controller, if the - * structure does not exist -1 is returned - * @param controller Name of the controller for which stats are requested. - */ -int cgroup_get_value_name_count(struct cgroup_controller *controller); - -/** - * Return the "index" variable for the specified controller, - * the return value is the pointer to the internal structure so - * don't dealocate it, or change the content of the memory space. - * @param controller Name of the controller for which stats are requested. - * @param index number of the variable. - */ -char *cgroup_get_value_name(struct cgroup_controller *controller, int index); -/* - * Config related stuff - */ -int cgroup_config_load_config(const char *pathname); -int cgroup_unload_cgroups(void); - -__END_DECLS - -#endif /* _LIBCG_H */ +#endif /* _LIBCGROUP_H */ |