qubesadmin.tools package

Submodules

qubesadmin.tools.dochelpers module

Documentation helpers.

This module contains classes and functions which help to maintain documentation, particularly our custom Sphinx extension.

class qubesadmin.tools.dochelpers.CommandCheckVisitor(command, sub_commands, document)

Bases: SparseNodeVisitor

Checks if the visited sub command section nodes and the specified sub command args are in sync.

check_undocumented_sub_commands()

Call this to check if any undocumented sub_commands are left.

While the documentation talks about a ‘SparseNodeVisitor.depart_document()’ function, this function does not exists. (For details see implementation of NodeVisitor.dispatch_departure()) So we need to manually call this.

visit_Text(node)

If the visited text node starts with ‘alias: ‘, all the provided comma separted alias in this node, are removed from self.sub_commands

visit_section(node)

Checks if the visited sub-command section nodes exists and it options are in sync.

Uses OptionsCheckVisitor for checking sub-commands options

class qubesadmin.tools.dochelpers.ManpageCheckVisitor(app, command, document)

Bases: SparseNodeVisitor

Checks if the sub-commands and options specified in the ‘COMMAND’ and ‘OPTIONS’ (case insensitve) sections in sync the command parser.

visit_section(node)

If section title is OPTIONS or COMMANDS dispatch the apropriate NodeVisitor.

class qubesadmin.tools.dochelpers.OptionsCheckVisitor(command, args, document)

Bases: SparseNodeVisitor

Checks if the visited option nodes and the specified args are in sync.

check_undocumented_arguments(ignored_options=None)

Call this to check if any undocumented arguments are left.

While the documentation talks about a ‘SparseNodeVisitor.depart_document()’ function, this function does not exists. (For details see implementation of NodeVisitor.dispatch_departure()) So we need to manually call this.

visit_desc(node)

Skips all but ‘option’ elements

visit_desc_name(node)

Checks if the option is defined self.args

qubesadmin.tools.dochelpers.break_to_pdb(app, *_dummy)

DEBUG

qubesadmin.tools.dochelpers.check_man_args(app, doctree, docname)

Checks the manpage for undocumented or obsolete sub-commands and options.

qubesadmin.tools.dochelpers.make_rst_section(heading, char)

Format a section header in rst

qubesadmin.tools.dochelpers.prepare_manpage(command)

Build a man page skeleton

qubesadmin.tools.dochelpers.setup(app)

Setup Sphinx extension

qubesadmin.tools.qubes_prefs module

Manipulate global properties.

qubesadmin.tools.qubes_prefs.get_parser()

Prepare argument parser

qubesadmin.tools.qubes_prefs.main(args=None, app=None)

qubesadmin.tools.qvm_backup module

qvm-backup tool

qubesadmin.tools.qvm_backup.main(args=None, app=None)

Main function of qvm-backup tool

qubesadmin.tools.qvm_backup.print_progress(expected_profile, _subject, _event, backup_profile, progress)

Event handler for reporting backup progress

qubesadmin.tools.qvm_backup.write_backup_profile(output_stream, args, passphrase=None)

Format backup profile and print it to output_stream (a file or stdout)

Parameters:

• output_stream – file-like object ro print the profile to

• args – parsed arguments

• passphrase – passphrase to use

qubesadmin.tools.qvm_backup_restore module

Console frontend for backup restore code

qubesadmin.tools.qvm_backup_restore.handle_broken(app, args, restore_info)

Display information about problems with VMs selected for resetore

qubesadmin.tools.qvm_backup_restore.main(args=None, app=None)

Main function of qvm-backup-restore

qubesadmin.tools.qvm_backup_restore.print_backup_log(backup_log)

Print a log on stdout, coloring it red if it’s a terminal

qubesadmin.tools.qvm_check module

Exits sucessfull if the provided domains exists, else returns failure

qubesadmin.tools.qvm_check.get_filters(args)

Get status and check functions

qubesadmin.tools.qvm_check.main(args=None, app=None)

Main function of qvm-check tool

qubesadmin.tools.qvm_check.print_msg(log, domains, status)

Print message in appropriate form about given domain(s)

qubesadmin.tools.qvm_clone module

Clone a domain

qubesadmin.tools.qvm_clone.main(args=None, app=None)

Clones an existing VM by copying all its disk files

qubesadmin.tools.qvm_create module

qvm-create tool

qubesadmin.tools.qvm_create.main(args=None, app=None)

Main function of qvm-create tool

qubesadmin.tools.qvm_device module

Qubes volume and block device managment

class qubesadmin.tools.qvm_device.DeviceAction(help='A backend & device id combination', required=True, allow_unknown=False, **kwargs)

Bases: QubesAction

Action for argument parser that gets the :py:class:qubesadmin.device.DeviceAssignment from a BACKEND:DEVICE_ID string.

parse_qubes_app(parser, namespace)

This method is called by qubes.tools.QubesArgumentParser after the namespace.app is instantiated. Oerwrite this method when extending qubes.tools.QubesAction to initialized values based on the namespace.app

class qubesadmin.tools.qvm_device.Line(device: DeviceInfo, attached_to=None)

Bases: object

Helper class to hold single device info for listing

property assignments

list of frontends the device is assigned to

qubesadmin.tools.qvm_device.attach_device(args)

Called by the parser to execute the qvm-devices attach subcommand.

qubesadmin.tools.qvm_device.detach_device(args)

Called by the parser to execute the qvm-devices detach subcommand.

qubesadmin.tools.qvm_device.get_parser(device_class=None)

Create argparse.ArgumentParser suitable for qvm-block.

qubesadmin.tools.qvm_device.init_list_parser(sub_parsers)

Configures the parser for the qvm-devices list subcommand

qubesadmin.tools.qvm_device.list_devices(args)

Called by the parser to execute the qubes-devices list subcommand.

qubesadmin.tools.qvm_device.main(args=None, app=None)

Main routine of qvm-block.

qubesadmin.tools.qvm_device.prepare_table(dev_list)

Converts a list of qubes.devices.DeviceInfo objects to a list of tupples for the qubes.tools.print_table().

If qvm-devices is running in a TTY, it will ommit duplicate data.

Parameters:

dev_list (iterable) – List of qubes.devices.DeviceInfo objects.

Returns:

list of tupples

qubesadmin.tools.qvm_features module

qvm-features - Manage domain’s features

qubesadmin.tools.qvm_features.main(args=None, app=None)

Main routine of qvm-features.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_firewall module

qvm-firewall tool

class qubesadmin.tools.qvm_firewall.RuleAction(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)

Bases: Action

Parser action for a single firewall rule. It accept syntax:

• <action> [<dsthost> [<proto> [<dstports>|<icmptype>]]]

• action=<action> [specialtarget=dns] [dsthost=<dsthost>] [proto=<proto>] [dstports=<dstports>] [icmptype=<icmptype>]

Or a mix of them.

qubesadmin.tools.qvm_firewall.main(args=None, app=None)

Main routine of qvm-firewall.

qubesadmin.tools.qvm_firewall.rules_add(vm, args)

Add a rule defined by args.rule

qubesadmin.tools.qvm_firewall.rules_del(vm, args)

Delete a rule according to args.rule/args.rule_no

qubesadmin.tools.qvm_firewall.rules_list_raw(vm)

Print rules in machine-readable form (as specified in Admin API)

Parameters:

vm – VM object

Returns:

None

qubesadmin.tools.qvm_firewall.rules_list_table(vm)

Print rules to stdout in human-readable form (table)

Parameters:

vm – VM object

Returns:

None

qubesadmin.tools.qvm_kill module

qvm-kill - forceful shutdown

qubesadmin.tools.qvm_kill.main(args=None, app=None)

Main routine of qvm-kill.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_ls module

qvm-ls - List available domains

class qubesadmin.tools.qvm_ls.Column(head, attr=None, doc=None)

Bases: object

A column in qvm-ls output characterised by its head and a way to fetch a parameter describing the domain.

Parameters:

• head (str) – Column head (usually uppercase).

• attr (str) – Attribute, possibly complex (containing .). This may also be a callable that gets as its only argument the domain.

• doc (str) – Description of column (will be visible in –help-columns).

cell(vm, insertion=0)

Format one cell.

Note

This is only for technical formatting (filling with space). If you want to subclass the Column class, you should override Column.format() method instead.

Parameters:

• qubes.vm.qubesvm.QubesVM – Domain to get a value from.

• insertion (int) – Intending to shift the value to the right.

Returns:

string to display

Return type:

str

columns = {'CLASS': Column(head='CLASS'), 'DISK': Column(head='DISK'), 'FLAGS': FlagsColumn(head='FLAGS'), 'GATEWAY': Column(head='GATEWAY'), 'MEMORY': Column(head='MEMORY'), 'PRIV-CURR': Column(head='PRIV-CURR'), 'PRIV-MAX': Column(head='PRIV-MAX'), 'PRIV-USED': Column(head='PRIV-USED'), 'ROOT-CURR': Column(head='ROOT-CURR'), 'ROOT-MAX': Column(head='ROOT-MAX'), 'ROOT-USED': Column(head='ROOT-USED'), 'STATE': Column(head='STATE')}

collection of all columns

format(vm)

Format one cell value.

Return value to put in a table cell.

Parameters:

qubes.vm.qubesvm.QubesVM – Domain to get a value from.

Returns:

Value to put, or None if no value.

Return type:

str or None

class qubesadmin.tools.qvm_ls.FlagsColumn

Bases: Column

Some fancy flags that describe general status of the domain.

autostart(vm)

If the domain is marked for autostart.

debug(vm)

If the domain is being debugged.

format(vm)

Format one cell value.

Return value to put in a table cell.

Parameters:

qubes.vm.qubesvm.QubesVM – Domain to get a value from.

Returns:

Value to put, or None if no value.

Return type:

str or None

classmethod get_flags()

Get all flags as list.

Holes between flags are filled with _no_flag().

Return type:

list

installed_by_rpm(vm)

If the domain is installed by RPM.

internal(vm)

If the domain is internal (not normally shown, no appmenus).

power(vm)

Current power state.

r running t transient p paused s suspended h halting d dying c crashed ? unknown

provides_network(vm)

If the domain provides network.

type(vm)

Type of domain.

0 AdminVM (AKA Dom0) aA AppVM dD DisposableVM sS StandaloneVM tT TemplateVM

When it is HVM (optimised VM), the letter is capital.

updateable(vm)

If the domain is updateable.

class qubesadmin.tools.qvm_ls.PropertyColumn(name)

Bases: Column

Column that displays value from property (property or qubes.property) of domain.

Parameters:

name – Name of VM property.

class qubesadmin.tools.qvm_ls.Table(domains, colnames, spinner, raw_data=False, tree_sorted=False)

Bases: object

Table that is displayed to the user.

Parameters:

• domains – Domains to include in the table.

• colnames (list) – Names of the columns (need not to be uppercase).

get_head()

Get table head data (all column heads).

get_row(vm, insertion=0)

Get single table row data (all columns for one domain).

sort_to_tree(domains)

Sort the domains as a network tree. It returns a list of sets. Each tuple stores the insertion of the cell name and the vm object.

Parameters:

domains (list()) – The domains which will be sorted

Return list(tuple()) tree:

returns a list of tuple(insertion, vm)

tree_append_child(parent, level)

Concatenate the network children of the vm to a list.

Parameters:

qubes.vm.qubesvm.QubesVM – Parent vm of the children VMs

write_table(stream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>)

Write whole table to file-like object.

Parameters:

stream (file) – Stream to write the table to.

qubesadmin.tools.qvm_ls.calc_size(vm, volume_name)

Calculates the volume size in MB

qubesadmin.tools.qvm_ls.calc_usage(vm, volume_name)

Calculates the volume usage in MB

qubesadmin.tools.qvm_ls.calc_used(vm, volume_name)

Calculates the volume usage in percent

qubesadmin.tools.qvm_ls.flag(field)

Mark method as flag field.

Parameters:

field (int) – Which field to fill (counted from 1)

qubesadmin.tools.qvm_ls.formats = {'disk': ('name', 'state', 'disk', 'priv-curr', 'priv-max', 'priv-used', 'root-curr', 'root-max', 'root-used'), 'full': ('name', 'state', 'class', 'label', 'qid', 'xid', 'uuid'), 'kernel': ('name', 'state', 'class', 'template', 'kernel', 'kernelopts'), 'network': ('name', 'state', 'netvm', 'ip', 'ipback', 'gateway'), 'simple': ('name', 'state', 'class', 'label', 'template', 'netvm')}

Available formats. Feel free to plug your own one.

qubesadmin.tools.qvm_ls.get_parser()

Create argparse.ArgumentParser suitable for qvm-ls.

qubesadmin.tools.qvm_ls.main(args=None, app=None)

Main routine of qvm-ls.

Parameters:

• args (list) – Optional arguments to override those delivered from command line.

• app – Operate on given app object instead of instantiating new one.

qubesadmin.tools.qvm_ls.matches_power_states(domain, **states)

Filter domains by their power state

qubesadmin.tools.qvm_ls.process_vm(vm)

Process VM object to find all listable properties.

Parameters:

vm (qubesmgmt.vm.QubesVM) – VM object.

qubesadmin.tools.qvm_ls.simple_flag(field, letter, attr, doc=None)

Create simple, binary flag.

Parameters:

• attr (str) – Attribute name to check. If result is true, flag is fired.

• letter (str) – The letter to show.

qubesadmin.tools.qvm_pause module

qvm-pause - Pause a domain

qubesadmin.tools.qvm_pause.main(args=None, app=None)

Main routine of qvm-pause.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_pool module

Manages Qubes pools and their options

qubesadmin.tools.qvm_pool.add_pool(args)

Adds a new pool

qubesadmin.tools.qvm_pool.get_parser()

Creates argparse.ArgumentParser suitable for qvm-pool.

qubesadmin.tools.qvm_pool.info_pools(args)

Prints info about the specified pools

qubesadmin.tools.qvm_pool.init_add_parser(sub_parsers)

Adds ‘add’ action related options

qubesadmin.tools.qvm_pool.init_info_parser(sub_parsers)

Adds ‘info’ action related options

qubesadmin.tools.qvm_pool.init_list_parser(sub_parsers)

Adds ‘list’ action related options

qubesadmin.tools.qvm_pool.init_remove_parser(sub_parsers)

Adds ‘remove’ action related options

qubesadmin.tools.qvm_pool.init_set_parser(sub_parsers)

Adds ‘set’ action related options

qubesadmin.tools.qvm_pool.list_drivers(args)

Lists all drivers with their options

qubesadmin.tools.qvm_pool.list_pools(args)

Lists all available pools

qubesadmin.tools.qvm_pool.main(args=None, app=None)

Main routine of qvm-pool.

qubesadmin.tools.qvm_pool.remove_pools(args)

Removes the specified pools

qubesadmin.tools.qvm_pool.set_pool(args)

Modifies driver options for a pool

qubesadmin.tools.qvm_pool.uses_legacy_options(args, app)

Checks if legacy options and used, and invokes the legacy tool

qubesadmin.tools.qvm_prefs module

Manipulate VM properties.

qubesadmin.tools.qvm_prefs.get_parser(vmname_nargs=1)

Return argument parser for generic property-related tool

qubesadmin.tools.qvm_prefs.main(args=None, app=None)

qubesadmin.tools.qvm_prefs.process_actions(parser, args, target)

Handle actions for generic property-related tool

Parameters:

• parser – argument parser used to produce args

• args – arguments to handle

• target – object on which actions should be performed

qubesadmin.tools.qvm_remove module

Remove domains from the system

qubesadmin.tools.qvm_remove.main(args=None, app=None)

qubesadmin.tools.qvm_run module

qvm-run tool

qubesadmin.tools.qvm_run.copy_stdin(stream)

Copy stdin to stream

qubesadmin.tools.qvm_run.main(args=None, app=None)

Main function of qvm-run tool

qubesadmin.tools.qvm_run.print_no_color(msg, file, color)

Print a msg to file without coloring it. Namely reset to base color first, print a message, then restore color.

qubesadmin.tools.qvm_run.run_command_single(args, vm)

Handle a single VM to run the command in

qubesadmin.tools.qvm_service module

qvm-service - Manage domain’s services

qubesadmin.tools.qvm_service.main(args=None, app=None)

Main routine of qvm-features.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_service.parse_bool(value)

Convert string value to bool according to well known representations

It accepts (case-insensitive) '0', 'no' and false as

False and '1', 'yes' and 'true' as True.

qubesadmin.tools.qvm_shutdown module

Shutdown a qube

qubesadmin.tools.qvm_shutdown.failed_domains(vms)

Find the domains that have not successfully been shut down

qubesadmin.tools.qvm_shutdown.main(args=None, app=None)

qubesadmin.tools.qvm_start module

qvm-start - start a domain

class qubesadmin.tools.qvm_start.DriveAction(option_strings, dest='drive', prefix='cdrom:', metavar='IMAGE', required=False, help='Attach drive')

Bases: Action

Action for argument parser that stores drive image path.

qubesadmin.tools.qvm_start.get_drive_assignment(app, drive_str)

Prepare qubesadmin.devices.DeviceAssignment object for a given drive.

If running in dom0, it will also take care about creating appropriate loop device (if necessary). Otherwise, only existing block devices are supported.

Parameters:

• app – Qubes() instance

• drive_str – drive argument

Returns:

DeviceAssignment matching drive_str

qubesadmin.tools.qvm_start.main(args=None, app=None)

Main routine of qvm-start.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_start_daemon module

GUI/AUDIO daemon launcher tool

class qubesadmin.tools.qvm_start_daemon.DAEMONLauncher(app: QubesBase, vm_names=None, kde=False)

Bases: object

Launch GUI/AUDIO daemon for VMs

cleanup_guid(xid)

Clean up after qubes-guid. Removes the auto-generated configuration file, if any.

common_guid_args(vm)

Common qubes-guid arguments for PV(H), HVM and Stubdomain

static guid_config_file(xid)

Helper function to construct a GUI configuration file path

static guid_pidfile(xid)

Helper function to construct a GUI pidfile path

is_watched(vm)

Should we watch this VM for changes

static kde_guid_args(vm)

Return KDE-specific arguments for gui-daemon, if applicable

on_connection_established(_subject, _event, **_kwargs)

Handler of ‘connection-established’ event, used to launch GUI/AUDIO daemon for domains started before this tool.

on_domain_spawn(vm, _event, **kwargs)

Handler of ‘domain-spawn’ event, starts GUI daemon for stubdomain

on_domain_start(vm, _event, **kwargs)

Handler of ‘domain-start’ event, starts GUI/AUDIO daemon for actual VM

on_domain_stopped(vm, _event, **_kwargs)

Handler of ‘domain-stopped’ event, cleans up

static pacat_domid(vm)

Determine target domid for an AUDIO daemon

static pacat_pidfile(xid)

Helper function to construct an AUDIO pidfile path

register_events(events)

Register domain startup events in app.events dispatcher

async send_monitor_layout(vm, layout=None, startup=False)

Send monitor layout to a given VM

This function is a coroutine.

Parameters:

• vm – VM to which send monitor layout

• layout – monitor layout to send; if None, fetch it from local X server.

• startup –

Returns:

None

send_monitor_layout_all()

Send monitor layout to all (running) VMs

async start_audio(vm)

Start AUDIO daemon regardless of start event.

This function is a coroutine.

Parameters:

vm – VM for which AUDIO daemon should be started

async start_audio_for_vm(vm)

Start AUDIO daemon (pacat-simple-vchan) connected directly to a VM

This function is a coroutine.

Parameters:

vm – VM for which start AUDIO daemon

async start_gui(vm, force_stubdom=False, monitor_layout=None)

Start GUI daemon regardless of start event.

This function is a coroutine.

Parameters:

• vm – VM for which GUI daemon should be started

• force_stubdom – Force GUI daemon for stubdomain, even if the one for target AppVM is running.

• monitor_layout – monitor layout configuration

async start_gui_for_stubdomain(vm, force=False)

Start GUI daemon (qubes-guid) connected to a stubdomain

This function is a coroutine.

async start_gui_for_vm(vm, monitor_layout=None)

Start GUI daemon (qubes-guid) connected directly to a VM

This function is a coroutine.

Parameters:

• vm – VM for which start GUI daemon

• monitor_layout – monitor layout to send; if None, fetch it from local X server.

static write_guid_config(config_path, config)

Write guid configuration to a file

class qubesadmin.tools.qvm_start_daemon.KeyboardLayout(binary_string)

Bases: object

Class to store and parse X Keyboard layout data

get_property(layout_num)

Return the selected keyboard layout as formatted for keyboard_layout property.

class qubesadmin.tools.qvm_start_daemon.XWatcher(conn, app)

Bases: object

Watch and react for X events related to the keyboard layout changes.

event_reader(callback)

Poll for X events related to keyboard layout

get_keyboard_layout()

Check what is current keyboard layout definition

get_selected_layout()

Check which keyboard layout is currently selected

initialize_extension()

Initialize XKB extension (not supported by xcffib by default

update_keyboard_layout()

Update current vm’s keyboard_layout property

qubesadmin.tools.qvm_start_daemon.escape_config_string(value)

Convert a string to libconfig format.

Format specification: http://www.hyperrealm.com/libconfig/libconfig_manual.html#String-Values

See dump_string() for python-libconf: https://github.com/Grk0/python-libconf/blob/master/libconf.py

qubesadmin.tools.qvm_start_daemon.get_monitor_layout()

Get list of monitors and their size/position

qubesadmin.tools.qvm_start_daemon.main(args=None)

Main function of qvm-start-daemon tool

qubesadmin.tools.qvm_start_daemon.retrieve_gui_daemon_options(vm, guivm)

Construct a list of GUI daemon options based on VM features.

This checks ‘gui-’ features on the VM, and if they’re absent, ‘gui-default-’ features on the GuiVM.

qubesadmin.tools.qvm_start_daemon.serialize_gui_daemon_options(options)

Prepare configuration file content for GUI daemon. Currently uses libconfig format.

qubesadmin.tools.qvm_tags module

qvm-tags - Manage domain’s tags

qubesadmin.tools.qvm_tags.get_parser()

Return qvm-tags tool command line parser

qubesadmin.tools.qvm_tags.main(args=None, app=None)

Main routine of qvm-tags.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_tags.mode_add(args)

Add tag

qubesadmin.tools.qvm_tags.mode_del(args)

Delete tag

qubesadmin.tools.qvm_tags.mode_query(args)

Query/list tags

qubesadmin.tools.qvm_template module

qubesadmin.tools.qvm_template_postprocess module

Tool for importing rpm-installed template

async qubesadmin.tools.qvm_template_postprocess.call_postinstall_service(vm)

Call qubes.PostInstall service

And adjust related settings (netvm, features).

qubesadmin.tools.qvm_template_postprocess.get_root_img_size(source_dir)

Extract size of root.img to be imported

qubesadmin.tools.qvm_template_postprocess.import_appmenus(vm, source_dir, skip_generate=True)

Import appmenus settings into VM object (later: GUI VM)

Parameters:

• vm – QubesVM object of just imported template

• source_dir – directory with source files

• skip_generate – do not generate actual menu entries, only set item lists

qubesadmin.tools.qvm_template_postprocess.import_root_img(vm, source_dir)

Import root.img into VM object

qubesadmin.tools.qvm_template_postprocess.import_template_config(args, conf_path, vm)

Parse template.conf and apply its content to the just installed TemplateVM

Parameters:

• args – arguments for qvm-template-postprocess (used for –allow-pv option and possibly some other in the future)

• conf_path – path to the template.conf

• vm – Template to operate on

Returns:

qubesadmin.tools.qvm_template_postprocess.is_chroot()

Detect if running inside chroot

qubesadmin.tools.qvm_template_postprocess.main(args=None, app=None)

Main function of qvm-template-postprocess

qubesadmin.tools.qvm_template_postprocess.parse_template_config(path)

Parse template.conf from template package. (KEY=VALUE format)

async qubesadmin.tools.qvm_template_postprocess.post_install(args)

Handle post-installation tasks

qubesadmin.tools.qvm_template_postprocess.pre_remove(args)

Handle pre-removal tasks

qubesadmin.tools.qvm_template_postprocess.reset_private_img(vm)

Clear private volume

qubesadmin.tools.qvm_template_postprocess.validate_ip(ip)

Check if given string has a valid IP address syntax

qubesadmin.tools.qvm_unpause module

qvm-unpause - Unpause a domain

qubesadmin.tools.qvm_unpause.main(args=None, app=None)

Main routine of qvm-unpause.

Parameters:

args (list) – Optional arguments to override those delivered from command line.

qubesadmin.tools.qvm_volume module

Qubes volume management

class qubesadmin.tools.qvm_volume.VolumeData(volume)

Bases: object

Wrapper object around qubes.storage.Volume, mainly to track the domains a volume is attached to.

qubesadmin.tools.qvm_volume.config_volume(args)

Change property of selected volume

qubesadmin.tools.qvm_volume.extend_volumes(args)

Called by the parser to execute the qvm-volume extend subcommand

qubesadmin.tools.qvm_volume.get_parser()

Create argparse.ArgumentParser suitable for qvm-volume.

qubesadmin.tools.qvm_volume.import_volume(args)

Import a file into volume

qubesadmin.tools.qvm_volume.info_volume(args)

Show info about selected volume

qubesadmin.tools.qvm_volume.init_config_parser(sub_parsers)

Add ‘info’ action related options

qubesadmin.tools.qvm_volume.init_extend_parser(sub_parsers)

Add ‘extend’ action related options

qubesadmin.tools.qvm_volume.init_import_parser(sub_parsers)

Add ‘import’ action related options

qubesadmin.tools.qvm_volume.init_info_parser(sub_parsers)

Add ‘info’ action related options

qubesadmin.tools.qvm_volume.init_list_parser(sub_parsers)

Configures the parser for the qvm-volume list subcommand

qubesadmin.tools.qvm_volume.init_revert_parser(sub_parsers)

Add ‘revert’ action related options

qubesadmin.tools.qvm_volume.list_volumes(args)

Called by the parser to execute the qvm-volume list subcommand.

qubesadmin.tools.qvm_volume.main(args=None, app=None)

Main routine of qvm-volume.

qubesadmin.tools.qvm_volume.prepare_table(vd_list, full=False)

Converts a list of VolumeData objects to a list of tupples for the qubes.tools.print_table().

If qvm-volume is running in a TTY, it will ommit duplicate data.

Parameters:

• vd_list (list) – List of VolumeData objects.

• full (bool) – If set to true duplicate data is printed even when running from TTY.

Returns:

list of tupples

qubesadmin.tools.qvm_volume.revert_volume(args)

Revert volume to previous state

Module contents

Qubes’ command line tools

class qubesadmin.tools.AliasedSubParsersAction(option_strings, prog, parser_class, dest='==SUPPRESS==', required=False, help=None, metavar=None)

Bases: _SubParsersAction

SubParser with support for action aliases

add_parser(name, **kwargs)

class qubesadmin.tools.PoolsAction(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)

Bases: QubesAction

Action for argument parser to gather multiple pools

parse_qubes_app(parser, namespace)

This method is called by qubes.tools.QubesArgumentParser after the namespace.app is instantiated. Oerwrite this method when extending qubes.tools.QubesAction to initialized values based on the namespace.app

class qubesadmin.tools.PropertyAction(option_strings, dest, metavar='NAME=VALUE', required=False, help='set property to a value')

Bases: Action

Action for argument parser that stores a property.

class qubesadmin.tools.QubesAction(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)

Bases: Action

Interface providing a convinience method to be called, after namespace.app is instantiated.

parse_qubes_app(parser, namespace)

This method is called by qubes.tools.QubesArgumentParser after the namespace.app is instantiated. Oerwrite this method when extending qubes.tools.QubesAction to initialized values based on the namespace.app

class qubesadmin.tools.QubesArgumentParser(vmname_nargs=None, show_forceroot=False, **kwargs)

Bases: ArgumentParser

Parser preconfigured for use in most of the Qubes command-line tools.

Parameters:

• vmname_nargs (mixed) – The number of VMNAME arguments that should be consumed. Values include: * N (an integer) consumes N arguments (and produces a list) * ‘?’ consumes zero or one arguments * ‘*’ consumes zero or more arguments (and produces a list) * ‘+’ consumes one or more arguments (and produces a list)

• show_forceroot – don’t hide –force-root parameter, prevent running as root unless it is given

kwargs are passed to argparser.ArgumentParser.

Currenty supported options:

--force-root (optional, ignored, help is suppressed) --offline-mode do not talk to hypervisor (help is suppressed) --verbose and --quiet

error_runtime(message, exit_code=1)

Runtime error, without showing usage.

Parameters:

message (str) – message to show

static get_loglevel_from_verbosity(namespace)

Return loglevel calculated from quiet and verbose arguments

parse_args(*args, **kwargs)

print_error(*args, **kwargs)

Print to sys.stderr

static set_qubes_verbosity(namespace)

Apply a verbosity setting.

This is done by configuring global logging. :param argparse.Namespace args: args as parsed by parser

class qubesadmin.tools.RunningVmNameAction(option_strings, nargs=1, dest='vmnames', help=None, **kwargs)

Bases: VmNameAction

Action for argument parser that gets a running domain from VMNAME

parse_qubes_app(parser, namespace)

This method is called by qubes.tools.QubesArgumentParser after the namespace.app is instantiated. Oerwrite this method when extending qubes.tools.QubesAction to initialized values based on the namespace.app

class qubesadmin.tools.SinglePropertyAction(option_strings, dest, metavar='VALUE', const=None, nargs=None, required=False, help=None)

Bases: Action

Action for argument parser that stores a property.

class qubesadmin.tools.SubParsersHelpAction(option_strings, dest='==SUPPRESS==', default='==SUPPRESS==', help=None)

Bases: _HelpAction

Print help for all options and all subparsers

class qubesadmin.tools.VMVolumeAction(help='A pool & volume id combination', required=True, **kwargs)

Bases: QubesAction

Action for argument parser that gets the :py:class:qubes.storage.Volume from a VM:VOLUME string.

parse_qubes_app(parser, namespace)

Acquire the :py:class:qubes.storage.Volume object from namespace.app.

qubesadmin.tools.VM_ALL = <object object>

constant returned when some action should be performed on all qubes

class qubesadmin.tools.VmNameAction(option_strings, nargs=1, dest='vmnames', help=None, **kwargs)

Bases: QubesAction

Action for parsing one ore multiple domains from provided VMNAMEs

parse_qubes_app(parser, namespace)

This method is called by qubes.tools.QubesArgumentParser after the namespace.app is instantiated. Oerwrite this method when extending qubes.tools.QubesAction to initialized values based on the namespace.app

class qubesadmin.tools.VmNameGroup(container, required, vm_action=<class 'qubesadmin.tools.VmNameAction'>, help=None)

Bases: _MutuallyExclusiveGroup

Adds an a VMNAME, –all & –exclude parameters to a :py:class:argparse.ArgumentParser`.

class qubesadmin.tools.VolumeAction(help='A pool & volume id combination', required=True, **kwargs)

Bases: QubesAction

Action for argument parser that gets the :py:class:qubes.storage.Volume from a POOL_NAME:VOLUME_ID string.

parse_qubes_app(parser, namespace)

Acquire the :py:class:qubes.storage.Volume object from namespace.app.

qubesadmin.tools.get_parser_for_command(command)

Get parser for given qvm-tool.

Parameters:

command (str) – command name

Return type:

argparse.ArgumentParser

Raises:

• ImportError – when command’s module is not found

• AttributeError – when parser was not found

qubesadmin.tools.print_table(table, stream=None)

Uses the unix column command to print pretty table.

Parameters:

text (str) – list of lists/sets