mirror of
https://github.com/SELinuxProject/selinux
synced 2025-01-18 03:10:50 +00:00
d5bcc2285f
With CIL, the filename and language extension are no longer stored in
the modules themselves like with pp files. So parse this information
from the filename when given a file to install, and require the
information be passed when just data. Symbolic versioning is used to
maintain ABI compatability with the old install functions. API
compatability is not maintained.
Also, remove version from the module info struct and the
semanage_module_info_{get,set}_version functions. These functions have
not been part of an official release, so removing them without providing
ABI/API compatability should not break anything.
Because versioning is removed, semanage_module_upgrade can no longer
perform the necessary checks to ensure an old module is not overriding
a newer module. So, this just remove the upgrade functions from the API.
Functions are added to maintain ABI compatability, which call the
install functions.
Also, CIL has no concept of a base module, so remove the notion of a
base module, including the API functions semanage_module_base_install
and related functions. To maintain ABI compatability, functions are
added which call the new install functions, thus treating base modules
as if they are normal modules.
Signed-off-by: Steve Lawrence <slawrence@tresys.com>
Signed-off-by: Yuli Khodorkovskiy <ykhodorkovskiy@tresys.com>
269 lines
7.8 KiB
C
269 lines
7.8 KiB
C
/* Authors: Joshua Brindle <jbrindle@tresys.com>
|
|
* Jason Tang <jtang@tresys.com>
|
|
*
|
|
* Copyright (C) 2005 Tresys Technology, LLC
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef _SEMANAGE_MODULES_H_
|
|
#define _SEMANAGE_MODULES_H_
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <semanage/handle.h>
|
|
|
|
typedef struct semanage_module_key semanage_module_key_t;
|
|
|
|
/* High level module management functions. These are all part of
|
|
* a transaction
|
|
*/
|
|
|
|
int semanage_module_install(semanage_handle_t *,
|
|
char *module_data, size_t data_len, char *name, char *ext_lang);
|
|
int semanage_module_install_file(semanage_handle_t *,
|
|
const char *module_name);
|
|
int semanage_module_remove(semanage_handle_t *, char *module_name);
|
|
|
|
/* semanage_module_info is for getting information on installed
|
|
modules, only name at this time */
|
|
typedef struct semanage_module_info semanage_module_info_t;
|
|
|
|
int semanage_module_list(semanage_handle_t *,
|
|
semanage_module_info_t **, int *num_modules);
|
|
void semanage_module_info_datum_destroy(semanage_module_info_t *);
|
|
semanage_module_info_t *semanage_module_list_nth(semanage_module_info_t * list,
|
|
int n);
|
|
const char *semanage_module_get_name(semanage_module_info_t *);
|
|
|
|
/* Module Info */
|
|
|
|
/* Creates a module info struct.
|
|
*
|
|
* Returns 0 on success and -1 on failure.
|
|
*
|
|
* The @modinfo should be destroyed with semanage_module_info_destroy.
|
|
* The caller should call free() on the struct.
|
|
*/
|
|
int semanage_module_info_create(semanage_handle_t *sh,
|
|
semanage_module_info_t **modinfo);
|
|
|
|
/* Frees the members of the module info struct.
|
|
*
|
|
* Returns 0 on success and -1 on failure.
|
|
*
|
|
* The caller should call free() on the struct.
|
|
*/
|
|
int semanage_module_info_destroy(semanage_handle_t *handle,
|
|
semanage_module_info_t *modinfo);
|
|
|
|
/* Module Info Getters */
|
|
|
|
/* Get @priority from @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_get_priority(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
uint16_t *priority);
|
|
|
|
/* Get @name from @modinfo. Caller should not free @name.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_get_name(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
const char **name);
|
|
|
|
/* Get @lang_ext from @modinfo. Caller should not free @lang_ext.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_get_lang_ext(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
const char **lang_ext);
|
|
|
|
/* Get @enabled from @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_get_enabled(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
int *enabled);
|
|
|
|
/* Module Info Setters */
|
|
|
|
/* Set @priority in @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_set_priority(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
uint16_t priority);
|
|
|
|
/* Set @name in @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_set_name(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
const char *name);
|
|
|
|
/* Set @lang_ext in @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_set_lang_ext(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
const char *lang_ext);
|
|
|
|
/* Set @enabled in @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_info_set_enabled(semanage_handle_t *sh,
|
|
semanage_module_info_t *modinfo,
|
|
int enabled);
|
|
|
|
/* Module Key */
|
|
|
|
/* Creates a module key struct.
|
|
*
|
|
* Return 0 on success, and -1 on error.
|
|
*
|
|
* The @modkey should be destroyed with semanage_module_key_destroy.
|
|
* The caller should call free() on the struct.
|
|
*/
|
|
int semanage_module_key_create(semanage_handle_t *sh,
|
|
semanage_module_key_t **modkey);
|
|
|
|
/* Frees members of the @modkey, but not the struct. The caller should
|
|
* call free() on struct.
|
|
*
|
|
* Returns 0 on success, and -1 on error.
|
|
*/
|
|
int semanage_module_key_destroy(semanage_handle_t *sh,
|
|
semanage_module_key_t *modkey);
|
|
|
|
/* Module Key Getters */
|
|
|
|
/* Get @name from @modkey. Caller should not free @name.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_key_get_name(semanage_handle_t *sh,
|
|
semanage_module_key_t *modkey,
|
|
const char **name);
|
|
|
|
/* Get @name from @modkey.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_key_get_priority(semanage_handle_t *sh,
|
|
semanage_module_key_t *modkey,
|
|
uint16_t *priority);
|
|
|
|
/* Module Key Setters */
|
|
|
|
/* Set @name in @modkey.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_key_set_name(semanage_handle_t *sh,
|
|
semanage_module_key_t *modkey,
|
|
const char *name);
|
|
|
|
/* Set @priority in @modkey.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_key_set_priority(semanage_handle_t *sh,
|
|
semanage_module_key_t *modkey,
|
|
uint16_t priority);
|
|
|
|
/* Set module @enabled status from @modkey. Modules are enabled on a per
|
|
* module name basis (across all priorities). @modkey only needs to have
|
|
* name set (priority is ignored).
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_set_enabled(semanage_handle_t *sh,
|
|
const semanage_module_key_t *modkey,
|
|
int enabled);
|
|
|
|
/* Lookup @modinfo by @modkey. Caller should use
|
|
* semanage_module_info_destroy and free on @modinfo.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_get_module_info(semanage_handle_t *sh,
|
|
const semanage_module_key_t *modkey,
|
|
semanage_module_info_t **modinfo);
|
|
|
|
/* Create a list of all modules in @modinfos of length @modinfos_len.
|
|
* The list will be sorted from high priority to low and alphabetically
|
|
* by module name within a priority.
|
|
*
|
|
* Caller should use semanage_module_info_destroy on each modinfo in
|
|
* @modinfos and free on @modinfos.
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_list_all(semanage_handle_t *sh,
|
|
semanage_module_info_t **modinfos,
|
|
int *modinfos_len);
|
|
|
|
/* Install the module indicated by @modinfo with input data from
|
|
* @module_data with length @data_len.
|
|
*
|
|
* @modinfo must have all values filled in.
|
|
* @module_data may be bzip compressed.
|
|
*
|
|
* Returns:
|
|
* 0 success
|
|
* -1 failure, out of memory
|
|
* -2 failure, invalid @modinfo
|
|
* -3 failure, error writing file
|
|
*/
|
|
int semanage_module_install_info(semanage_handle_t *sh,
|
|
const semanage_module_info_t *modinfo,
|
|
char *data,
|
|
size_t data_len);
|
|
|
|
/* Remove the module indicated by @modkey.
|
|
* @modkey must have key values filled in.
|
|
*
|
|
* Returns:
|
|
* 0 success
|
|
* -1 failure, out of memeory
|
|
* -2 failure, @module not found or couldn't be removed
|
|
*/
|
|
int semanage_module_remove_key(semanage_handle_t *sh,
|
|
const semanage_module_key_t *modkey);
|
|
|
|
/* Module Enabled */
|
|
|
|
/* Get module @enabled status from @modkey. Modules are enabled on a per
|
|
* module name basis (across all priorities). @modkey only needs to have
|
|
* name set (priority is ignored).
|
|
*
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int semanage_module_get_enabled(semanage_handle_t *sh,
|
|
const semanage_module_key_t *modkey,
|
|
int *enabled);
|
|
|
|
#endif
|