---
name: "oneimage"
section: "1"
platform: "linux"
package: "opennebula-tools"
version: "3.4.1-3.1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/oneimage"
---

# oneimage(1)

## NAME

**oneimage**

## SYNOPSIS

**oneimage** *command* \[*args*\] \[*options*\]

## OPTIONS

```
 -d, --datastore id|name   Selects the datastore
 -l, --list x,y,z          Selects columns to display with list command
 -d, --delay x             Sets the delay in seconds for top command
 -x, --xml                 Show the resource in xml format
 -n, --numeric             Do not translate user and group IDs
 -v, --verbose             Verbose mode
 -h, --help                Show this message
 -V, --version             Show version and copyright information
```

## COMMANDS

- •

  create *file*

-

  ```
  Creates a new Image from the given template file
  valid options: datastore
  ```

-

  - •

  delete *range\|imageid\_list*

-

  ```
  Deletes the given Image
  ```

-

  - •

  publish *range\|imageid\_list*

-

  ```
  DEPRECATED, use chmod instead. Publishes the given Image. A public Image
  can be seen and used by other users in the Image´s group.
  ```

-

  - •

  unpublish *range\|imageid\_list*

-

  ```
  DEPRECATED, use chmod instead. Unpublishes the given Image. A private
  Image can´t be used by any other user.
  ```

-

  - •

  persistent *range\|imageid\_list*

-

  ```
  Makes the given Image persistent. A persistent Image saves the changes
  made to the contents after the VM instance is shutdown (or in real time
  if a shared FS is used). Persistent Images can be used by only
  one VM instance at a time.
  ```

-

  - •

  nonpersistent *range\|imageid\_list*

-

  ```
  Makes the given Image non persistent. See ´oneimage persistent´
  ```

-

  - •

  update *imageid*

-

  ```
  Launches the system editor to modify and update the template contents
  ```

-

  - •

  enable *range\|imageid\_list*

-

  ```
  Enables the given Image
  ```

-

  - •

  chtype *range\|imageid\_list* *type*

-

  ```
  Changes the Image´s type
  ```

-

  - •

  disable *range\|imageid\_list*

-

  ```
  Disables the given Image
  ```

-

  - •

  chgrp *range\|imageid\_list* *groupid*

-

  ```
  Changes the Image group
  ```

-

  - •

  chown *range\|imageid\_list* *userid* \[*groupid*\]

-

  ```
  Changes the Image owner and group
  ```

-

  - •

  chmod *range\|imageid\_list* *octet*

-

  ```
  Changes the Image permissions
  ```

-

  - •

  list \[*filterflag*\]

-

  ```
  Lists Images in the pool
  valid options: list, delay, xml, numeric
  ```

-

  - •

  show *imageid*

-

  ```
  Shows information for the given Image
  valid options: xml
  ```

-

  - •

  top \[*filterflag*\]

-

  ```
  Lists Images continuously
  valid options: list, delay, xml, numeric
  ```

-

  -

  ## ARGUMENT FORMATS

- •

  file

-

  ```
  Path to a file
  ```

-

  - •

  range

-

  ```
  List of id´s in the form 1,8..15
  ```

-

  - •

  text

-

  ```
  String
  ```

-

  - •

  groupid

-

  ```
  OpenNebula GROUP name or id
  ```

-

  - •

  userid

-

  ```
  OpenNebula USER name or id
  ```

-

  - •

  imageid

-

  ```
  OpenNebula IMAGE name or id
  ```

-

  - •

  imageid\_list

-

  ```
  Comma-separated list of OpenNebula IMAGE names or ids
  ```

-

  - •

  filterflag

-

  ```
  a, all       all the known IMAGEs
  m, mine      the IMAGE belonging to the user in ONE_AUTH
  g, group     ´mine´ plus the IMAGE belonging to the groups
               the user is member of
  uid          IMAGE of the user identified by this uid
  user         IMAGE of the user identified by the username
  ```

-

  -

  ## LICENSE

OpenNebula 3.4.1 Copyright 2002-2012, OpenNebula Project Leads (OpenNebula.org)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0