summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJoshua Powers <josh.powers@canonical.com>2019-12-11 14:28:49 -0800
committerGitHub <noreply@github.com>2019-12-11 14:28:49 -0800
commite48081e7b88ae9add3c08cb248a2d3f99f863bd1 (patch)
tree985d580db94626cc63f3848682b1708d8a98098a /doc
parentc78fddea409b5b699572f19e2db6bfdc4ded4894 (diff)
downloadvyos-cloud-init-e48081e7b88ae9add3c08cb248a2d3f99f863bd1.tar.gz
vyos-cloud-init-e48081e7b88ae9add3c08cb248a2d3f99f863bd1.zip
docs: add cloud-init-per manpage
Diffstat (limited to 'doc')
-rw-r--r--doc/man/cloud-init-per.145
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/man/cloud-init-per.1 b/doc/man/cloud-init-per.1
new file mode 100644
index 00000000..3668232e
--- /dev/null
+++ b/doc/man/cloud-init-per.1
@@ -0,0 +1,45 @@
+.TH CLOUD-INIT-PER 1
+
+.SH NAME
+cloud-init-per \- Run a command with arguments at a specific frequency
+
+.SH SYNOPSIS
+.BR "cloud-init-per" " <frequency> <name> <cmd> [ arg1 [ arg2 [...]]]"
+
+.SH DESCRIPTION
+Run a command with arguments at a specific frequency.
+
+This utility can make it easier to use boothooks or bootcmd on a per
+"once" or "always" basis. For example:
+
+ - [ cloud-init-per, once, mymkfs, mkfs, /dev/vdb ]
+
+The cloud-init-per command replaced the cloud-init-run-module command.
+
+.SH OPTIONS
+.TP
+.B "frequency"
+This can be one of the following values:
+
+.BR "once" ":"
+run only once and do not re-run for new instance-id
+
+.BR "instance" ":"
+run only the first boot for a given instance-id
+
+.BR "always" ":"
+run every boot
+
+.TP
+.B "name"
+A name to give the command to run to show up in logs.
+
+.TP
+.B "cmd [ arg1 [ arg2 [...]]]"
+The actual command to run followed by any additional arguments.
+
+.SH COPYRIGHT
+Copyright (C) 2020 Canonical Ltd. License GPL-3 or Apache-2.0
+
+.SH SEE ALSO
+Full documentation at: <https://cloudinit.readthedocs.io>