require 'lxc'

# Check if all lxc binaries are installed
LXC.installed?

# Get LXC version
LXC.version

# Get current LXC configuration
LXC.config

# Get a list of all containers
LXC.containers

# Get a single container by name
LXC.container('name')

c = LXC.container('foo')

# Get current status of container
c.state  # => 'running'
c.pid    # => 1234
c.status # => <LXC::Status @state='running' @pid=123456>

# Check if container exists?
#
# This is needed since lxc does not raise any errors if container is
# not present in the system, and returns the same result as if container
# is actually stopped
c.exists? # => true

# Status helpers
c.running? # => true
c.stopped? # => false
c.frozen?  # => false

# Start and stop containers
c.start # will be started in daemonized mode
c.stop

# Free and unfreeze (also returns current status)
c.freeze
c.unfreeze

# Destroy container
c.destroy # => true

# Get container memory usage (in bytes)
c.memory_usage
c.memory_limit

# Get container cpu shares and usage (in seconds)
c.cpu_shares # => 1024
c.cpu_usage  # => 4312.08

# Get running processes
c.processes
# =>
#[{"pid"=>"27404",
#   "user"=>"root",
#   "cpu"=>"0.0",
#   "memory"=>"0.1",
#   "command"=>"/sbin/init",
#   "args"=>""}]

c = LXC::Container.new('foo')
c.create(path_to_lxc_config)

LXC.use_sudo = true