iterators.h

/* SPDX-License-Identifier: LGPL-2.1-only */
#ifndef _LIBCGROUP_ITERATORS_H
#define _LIBCGROUP_ITERATORS_H
 
#ifndef _LIBCGROUP_H_INSIDE
#error "Only <libcgroup.h> should be included directly."
#endif
 
#ifndef SWIG
#include <sys/types.h>
#include <stdio.h>
#include <features.h>
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum cgroup_walk_type {
    CGROUP_WALK_TYPE_PRE_DIR = 0x1,
    CGROUP_WALK_TYPE_POST_DIR = 0x2,
};
 
enum cgroup_file_type {
    CGROUP_FILE_TYPE_FILE,      
    CGROUP_FILE_TYPE_DIR,       
    CGROUP_FILE_TYPE_OTHER,     
};
 
struct cgroup_file_info {
    enum cgroup_file_type type;
    const char *path;
    const char *parent;
    const char *full_path;
    short depth;
};
 
int cgroup_walk_tree_begin(const char *controller, const char *base_path, int depth,
               void **handle, struct cgroup_file_info *info,
               int *base_level);
 
int cgroup_walk_tree_next(int depth, void **handle, struct cgroup_file_info *info, int base_level);
 
int cgroup_walk_tree_end(void **handle);
 
int cgroup_walk_tree_set_flags(void **handle, int flags);
 
int cgroup_read_value_begin(const char * const controller, const char *path,
                const char * const name, void **handle,
                char *buffer, int max);
 
int cgroup_read_value_next(void **handle, char *buffer, int max);
 
int cgroup_read_value_end(void **handle);
 
#define CG_VALUE_MAX 100
struct cgroup_stat {
    char name[FILENAME_MAX];
    char value[CG_VALUE_MAX];
};
 
int cgroup_read_stats_begin(const char *controller, const char *path, void **handle,
                struct cgroup_stat *stat);
 
int cgroup_read_stats_next(void **handle, struct cgroup_stat *stat);
 
int cgroup_read_stats_end(void **handle);
 
int cgroup_get_task_begin(const char *cgrp, const char *controller, void **handle, pid_t *pid);
 
int cgroup_get_task_next(void **handle, pid_t *pid);
 
int cgroup_get_task_end(void **handle);
 
struct cgroup_mount_point {
    char name[FILENAME_MAX];
    char path[FILENAME_MAX];
};
 
int cgroup_get_controller_begin(void **handle, struct cgroup_mount_point *info);
 
int cgroup_get_controller_next(void **handle, struct cgroup_mount_point *info);
 
int cgroup_get_controller_end(void **handle);
 
struct controller_data {
    char name[FILENAME_MAX];
    int hierarchy;
    int num_cgroups;
    int enabled;
};
 
int cgroup_get_all_controller_begin(void **handle, struct controller_data *info);
int cgroup_get_all_controller_next(void **handle, struct controller_data *info);
 
int cgroup_get_all_controller_end(void **handle);
 
int cgroup_get_subsys_mount_point_begin(const char *controller, void **handle, char *path);
 
int cgroup_get_subsys_mount_point_next(void **handle, char *path);
 
int cgroup_get_subsys_mount_point_end(void **handle);
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* _LIBCGROUP_ITERATORS_H */