sbuild
1.6.10
|
A chroot stored on an unmounted block device. More...
#include <sbuild-chroot-block-device.h>
Public Member Functions | |
virtual | ~chroot_block_device () |
The destructor. | |
virtual chroot::ptr | clone () const |
Copy the chroot. More... | |
virtual chroot::ptr | clone_session (std::string const &session_id, std::string const &alias, std::string const &user, bool root) const |
Create a session chroot. More... | |
virtual chroot::ptr | clone_source () const |
Create a source chroot. More... | |
std::string const & | get_chroot_type () const |
Get the type of the chroot. More... | |
virtual void | setup_env (chroot const &chroot, environment &env) const |
Set environment. More... | |
virtual session_flags | get_session_flags (chroot const &chroot) const |
Get the session flags of the chroot. More... | |
![]() | |
virtual | ~chroot_block_device_base () |
The destructor. | |
std::string const & | get_device () const |
Get the block device of the chroot. More... | |
void | set_device (std::string const &device) |
Set the block device of the chroot. More... | |
virtual std::string | get_path () const |
Get the path to the chroot. More... | |
![]() | |
virtual | ~chroot () |
The destructor. | |
std::string const & | get_name () const |
Get the name of the chroot. More... | |
void | set_name (std::string const &name) |
Set the name of the chroot. More... | |
std::string const & | get_description () const |
Get the description of the chroot. More... | |
void | set_description (std::string const &description) |
Set the description of the chroot. More... | |
std::string const & | get_mount_location () const |
Get the mount location of the chroot. More... | |
void | set_mount_location (std::string const &location) |
Set the mount location of the chroot. More... | |
string_list const & | get_users () const |
Get the users allowed to access the chroot. More... | |
void | set_users (string_list const &users) |
Set the users allowed to access the chroot. More... | |
string_list const & | get_groups () const |
Get the groups allowed to access the chroot. More... | |
void | set_groups (string_list const &groups) |
Set the users allowed to access the chroot. More... | |
string_list const & | get_root_users () const |
Get the users allowed to access the chroot as root. More... | |
void | set_root_users (string_list const &users) |
Set the users allowed to access the chroot as root. More... | |
string_list const & | get_root_groups () const |
Get the groups allowed to access the chroot as root. More... | |
void | set_root_groups (string_list const &groups) |
Set the groups allowed to access the chroot as root. More... | |
string_list const & | get_aliases () const |
Get the aliases of the chroot. More... | |
void | set_aliases (string_list const &aliases) |
Set the aliases of the chroot. More... | |
bool | get_preserve_environment () const |
Check if the environment should be preserved in the chroot. More... | |
void | set_preserve_environment (bool preserve_environment) |
Set if the environment should be preserved in the chroot. More... | |
std::string const & | get_default_shell () const |
Get default shell. More... | |
void | set_default_shell (std::string const &default_shell) |
Set the default shell. More... | |
regex const & | get_environment_filter () const |
Get the environment filter of the chroot. More... | |
void | set_environment_filter (regex const &environment_filter) |
Set the environment filter of the chroot. More... | |
bool | get_active () const |
Get the activity status of the chroot. More... | |
bool | get_original () const |
Get the originality of the chroot. More... | |
void | set_original (bool original) |
Set the originality of the chroot. More... | |
bool | get_run_setup_scripts () const |
Check if chroot setup scripts will be run. More... | |
std::string const & | get_script_config () const |
Get the script configuration file for the chroot. More... | |
void | set_script_config (std::string const &script_config) |
Set the script configuration file for the chroot. More... | |
std::string const & | get_profile () const |
Get the configuration profile for the chroot. More... | |
void | set_profile (std::string const &profile) |
Set configuration profile for the chroot. More... | |
string_list const & | get_command_prefix () const |
Get the command_prefix for the chroot. More... | |
void | set_command_prefix (string_list const &command_prefix) |
Set the command_prefix for the chroot. More... | |
verbosity | get_verbosity () const |
Get the message verbosity. More... | |
const char * | get_verbosity_string () const |
Get the message verbosity as a readable string. More... | |
void | set_verbosity (verbosity verbosity) |
Set the message verbosity. More... | |
void | set_verbosity (std::string const &verbosity) |
Set the message verbosity. More... | |
void | setup_env (environment &env) const |
Set environment. More... | |
void | lock (setup_type type) |
Lock a chroot during setup. More... | |
void | unlock (setup_type type, int status) |
Unlock a chroot during setup. More... | |
template<typename T > | |
std::shared_ptr< T > | get_facet () |
Get a chroot facet. More... | |
template<typename T > | |
const std::shared_ptr< const T > | get_facet () const |
Get a chroot facet. More... | |
template<typename T > | |
void | add_facet (std::shared_ptr< T > facet) |
Add a chroot facet. More... | |
template<typename T > | |
void | remove_facet () |
Remove a chroot facet. More... | |
template<typename T > | |
void | remove_facet (std::shared_ptr< T > facet) |
Remove a chroot facet. More... | |
template<typename T > | |
void | replace_facet (std::shared_ptr< T > facet) |
Replace an existing chroot facet with a new facet. More... | |
string_list | list_facets () const |
List all registered chroot facets. More... | |
session_flags | get_session_flags () const |
Get the session flags of the chroot. More... | |
void | get_details (format_detail &detail) const |
Get detailed information about the chroot for output. More... | |
void | print_details (std::ostream &stream) const |
Print detailed information about the chroot to a stream. More... | |
void | get_keyfile (keyfile &keyfile) const |
Copy the chroot properties into a keyfile. More... | |
void | set_keyfile (keyfile const &keyfile) |
Set the chroot properties from a keyfile. More... | |
Protected Member Functions | |
chroot_block_device () | |
The constructor. | |
chroot_block_device (const chroot_block_device &rhs) | |
The copy constructor. | |
chroot_block_device (const chroot_lvm_snapshot &rhs) | |
The copy constructor. | |
virtual void | setup_lock (chroot::setup_type type, bool lock, int status) |
Unlock a chroot during setup. More... | |
virtual void | get_details (chroot const &chroot, format_detail &detail) const |
Get detailed information about the chroot for output. More... | |
virtual void | get_keyfile (chroot const &chroot, keyfile &keyfile) const |
Copy the chroot properties into a keyfile. More... | |
virtual void | set_keyfile (chroot &chroot, keyfile const &keyfile, string_list &used_keys) |
Set the chroot properties from a keyfile. More... | |
![]() | |
chroot_block_device_base () | |
The constructor. | |
chroot_block_device_base (const chroot_block_device_base &rhs) | |
The copy constructor. | |
![]() | |
chroot () | |
The constructor. | |
chroot (const chroot &rhs) | |
The copy constructor. More... | |
void | set_run_setup_scripts (bool run_setup_scripts) |
Set whether chroot setup scripts will be run. More... | |
virtual void | setup_session_info (bool start) |
Set up persistent session information. More... | |
Friends | |
class | chroot |
class | chroot_lvm_snapshot |
Additional Inherited Members | |
![]() | |
static ptr | create (std::string const &type) |
Create a chroot. More... | |
![]() | |
std::string | device |
The block device to use. | |
A chroot stored on an unmounted block device.
The device will be mounted on demand.
|
virtual |
Copy the chroot.
This is a virtual copy constructor.
Implements sbuild::chroot.
References chroot_block_device().
Referenced by clone_source().
|
virtual |
Create a session chroot.
session_id | the identifier (session_id) for the new session. |
alias | used to initially identify the chroot. |
user | the user creating the session. |
root | true if the user has root access, otherwise false. |
Implements sbuild::chroot.
References chroot_block_device().
|
virtual |
Create a source chroot.
Implements sbuild::chroot.
References chroot_block_device(), and clone().
|
virtual |
|
protectedvirtual |
Get detailed information about the chroot for output.
chroot | the chroot to use. |
detail | the details to output to. |
Reimplemented from sbuild::chroot_block_device_base.
References sbuild::chroot_block_device_base::get_details().
|
protectedvirtual |
Copy the chroot properties into a keyfile.
The keyfile group with the name of the chroot will be set; if it already exists, it will be removed before setting it.
chroot | the chroot to use. |
keyfile | the keyfile to use. |
Reimplemented from sbuild::chroot_block_device_base.
References sbuild::chroot_block_device_base::get_keyfile().
|
virtual |
Get the session flags of the chroot.
These determine how the Session controlling the chroot will operate.
chroot | the chroot to use. |
Reimplemented from sbuild::chroot_block_device_base.
References sbuild::chroot::get_session_flags().
|
protectedvirtual |
Set the chroot properties from a keyfile.
The chroot name must have previously been set, so that the correct keyfile group may be determined.
chroot | the chroot to use. |
keyfile | the keyfile to get the properties from. |
used_keys | a list of the keys used will be set. |
Reimplemented from sbuild::chroot_block_device_base.
References sbuild::chroot_block_device_base::set_keyfile().
|
virtual |
Set environment.
Set the environment that the setup scripts will see during execution.
chroot | the chroot to use. |
env | the environment to set. |
Reimplemented from sbuild::chroot_block_device_base.
References sbuild::chroot_block_device_base::setup_env().
|
protectedvirtual |
Unlock a chroot during setup.
The locking technique (if any) may vary depending upon the chroot type and setup stage. For example, during creation of an LVM snapshot a block device might require locking, but afterwards this will change to the new block device.
An error will be thrown on failure.
type | the type of setup being performed |
lock | true to lock, false to unlock |
status | the exit status of the setup commands (0 for success, nonzero for failure). |
Implements sbuild::chroot.
References sbuild::chroot::DEVICE_NOTBLOCK, sbuild::chroot_block_device_base::get_device(), sbuild::chroot::get_facet(), sbuild::chroot::setup_session_info(), sbuild::chroot::SETUP_START, and sbuild::chroot::SETUP_STOP.