snf-mkimage.rst 1.92 KB
Newer Older
1 2 3
:orphan:

snf-mkimage manual page
4
=======================
5 6 7 8

Synopsis
--------

9
**snf-mkimage** [OPTION] <INPUT MEDIA>
10 11 12 13 14

Description
-----------
Create image out of an <INPUT MEDIA>. The <INPUT MEDIA> may be a block device,
a regular file that represents a hard disk or \`/' to bundle the host system
15
itself.
16 17 18

Options
-------
19 20 21
-a URL, --authentication-url=URL
	use this authentication URL when uploading/registering images

Nikos Skalkotos's avatar
Nikos Skalkotos committed
22 23 24
--allow-unsupported
	Proceed with the image creation even if the media is not supported

25 26 27 28 29 30 31 32 33 34 35 36 37
-c CLOUD, --cloud=CLOUD
        use this saved cloud account to authenticate against a cloud when
        uploading/registering images

--disable-sysprep=SYSPREP
	prevent SYSPREP operation from running on the input media

--enable-sysprep=SYSPREP
	run SYSPREP operation on the input media

-f, --force
	overwrite output files if they exist

38 39
-h, --help
	show this help message and exit
40 41 42 43 44 45 46

-m KEY=VALUE, --metadata=KEY=VALUE
	add custom KEY=VALUE metadata to the image

--no-shrink
	don't shrink any partition

47 48 49
--no-snapshot
	don't snapshot the input media. (THIS IS DANGEROUS AS IT WILL ALTER THE
	ORIGINAL MEDIA!!!)
50 51 52 53 54 55 56 57 58 59 60 61 62
--no-sysprep
	don't perform any system preparation operation

-o FILE, --outfile=FILE
	dump image to FILE

--public
	register image with the storage service as public

--print-syspreps
	print the enabled and disabled system preparation operations for this
	input media

Nikos Skalkotos's avatar
Nikos Skalkotos committed
63 64 65
--print-sysprep-params
	print the needed sysprep parameters for this input media

66 67 68 69 70 71
-r IMAGENAME, --register=IMAGENAME
	register the image with the compute service with name IMAGENAME

-s, --silent
	output only errors

Nikos Skalkotos's avatar
Nikos Skalkotos committed
72 73 74
--sysprep-param=SYSPREP_PARAMS
	add KEY=VALUE system preparation parameter

75 76 77
-t TOKEN, --token=TOKEN
	use this token when uploading/registering images

78 79
--tmpdir=DIR
	create large temporary image files under DIR
80 81 82 83 84 85 86

-u FILENAME, --upload=FILENAME
	save the image to the storage service with remote name FILENAME

--version
	show program's version number and exit