Source code for qubesadmin.tools.qvm_pause

# encoding=utf-8
#
# The Qubes OS Project, https://www.qubes-os.org/
#
# Copyright (C) 2010-2015  Joanna Rutkowska <joanna@invisiblethingslab.com>
# Copyright (C) 2015       Wojtek Porczyk <woju@invisiblethingslab.com>
#
# This program 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 program 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 program; if not, see <http://www.gnu.org/licenses/>.

'''qvm-pause - Pause a domain'''

import asyncio
import sys
import qubesadmin


parser = qubesadmin.tools.QubesArgumentParser(vmname_nargs='+',
    description='pause a qube',
    epilog='Paused qubes will be killed on system shutdown.')

parser.add_argument(
    "--suspend",
    "-S",
    action="store_true",
    help="Put the qube to (S3) suspend mode instead of emergency pause",
)




def main(args=None, app=None):
    '''Main routine of :program:`qvm-pause`.

    :param list args: Optional arguments to override those delivered from \
        command line.
    '''

    args = parser.parse_args(args, app=app)
    exit_code = 0
    if args.suspend:
        action = "suspend"
        failed = asyncio.run(qubesadmin.utils.suspend(domains=args.domains))
    else:
        action = "pause"
        failed = asyncio.run(qubesadmin.utils.pause(domains=args.domains))
    if failed:
        exit_code = 1
        for qube, exc in failed.items():
            parser.print_error("Failed to {}: {}: {}".format(action, qube, exc))

    return exit_code



if __name__ == '__main__':
    sys.exit(main())