=head1 NAME

virt-sandbox-service - Secure container tool

=head1 SYNOPSIS

  {create,clone,connect,delete,execute,reload,upgrade}

  commands:

    create              create a sandbox container

    clone               Clone an existing sandbox container

    connect             Connect to a sandbox container

    delete              Delete a sandbox container

    execute             Execute a command within a sandbox container

    reload              Reload a running sandbox container

    upgrade             Upgrade an existing sandbox container

=head1 DESCRIPTION

virt-sandbox-service is used to provision secure sandboxed system services.
These applications will be launched via libvirt and run within a virtualization
technology such as LinuX Containers (LXC), or optionally QEMU/KVM. The
container / virtual machines will be secured by SELinux and resource
separated using cgroups.

By default, it will use the libvirt LXC driver, with the C<lxc:///> URI.
This is different from libvirt's normal behaviour, which is to probe
for the best URI to use. Thus if using C<virsh> to get a list of containers,
one must specify an explicit URI for it, C<virsh -c lxc:///>. Alternatively
the C<LIBVIRT_DEFAULT_URI> environment variable can be set, or the config
file C</etc/libvirt/libvirt.conf> can have a default URI set.

=head1 OPTIONS

=over 4

=item B<-h>, B<--help>

Display help message

=item B<-c URI>, B<--connect URI>

The connection URI for the hypervisor (currently only LXC URIs are
supported).

=back

=head1 SEE ALSO

C<libvirt(8)>, C<selinux(8)>, C<systemd(8)>, C<virt-sandbox(1)>,
C<virt-sandbox-service-create(1)>, C<virt-sandbox-service-clone(1)>,
C<virt-sandbox-service-connect(1)>, C<virt-sandbox-service-delete(1)>,
C<virt-sandbox-service-execute(1)>, C<virt-sandbox-service-reload(1)>,
C<virt-sandbox-service-upgrade(1)>

=head1 FILES

Container content will be stored in subdirectories of
/var/lib/libvirt/filesystems, by default.  You can manage the
content in these directories outside of the container and
processes within the container will see the content.

=head1 AUTHORS

Daniel Walsh <dwalsh@redhat.com>

Daniel P. Berrange <dan@berrange.com>

=head1 COPYRIGHT

Copyright (C) 2011-2013 Red Hat, Inc.

=head1 LICENSE

virt-sandbox is distributed under the terms of the GNU LGPL v2+.
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE
