import man pages changes

Signed-off-by: Steven Armstrong <steven@icarus.ethz.ch>
This commit is contained in:
Steven Armstrong 2011-04-05 22:46:51 +02:00
parent da532a9068
commit 90af07b9f5
2 changed files with 41 additions and 12 deletions

View file

@ -0,0 +1,31 @@
cdist-object-all(1)
===================
Steven Armstrong <steven-cdist--@--armstrong.cc>
NAME
----
cdist-object-all - Run the given command on all objects
SYNOPSIS
--------
cdist-object-all HOSTNAME COMMAND
DESCRIPTION
-----------
Iterates over all defined objects and executes the given command on each
of them.
SEE ALSO
--------
- cdist(7)
- cdist-type(1)
COPYING
-------
Copyright \(C) 2011 Steven Armstrong. Free use of this software is
granted under the terms of the GNU General Public License version 3 (GPLv3).

View file

@ -11,8 +11,8 @@ DESCRIPTION
----------- -----------
Starting the execution of deployment with cdist-deploy-to(1), cdist passes Starting the execution of deployment with cdist-deploy-to(1), cdist passes
through different stages, each can be triggered and debugged on its own. through different stages, each can be triggered and debugged on its own.
Reading the source of the cdist-deploy-to and cdist-object-run-all executables Reading the source of the cdist-deploy-to executable shows the scripts
shows the scripts responsible for each stage. responsible for each stage.
STAGE 0: INTERNAL PREPERATION STAGE 0: INTERNAL PREPERATION
@ -56,7 +56,7 @@ STAGE 3: OBJECT INFORMATION RETRIEVAL
------------------------------------- -------------------------------------
Every object is checked whether its type has explorers and if so, these are Every object is checked whether its type has explorers and if so, these are
transfered to the target host and executed. The results are transfered back transfered to the target host and executed. The results are transfered back
and can be used in the following stages to decide what changes need to made and can be used in the following stages to decide what changes need to be made
on the target to implement the desired state. on the target to implement the desired state.
Related documentation: Related documentation:
@ -68,10 +68,9 @@ Related documentation:
STAGE 4: RUN THE OBJECT MANIFEST STAGE 4: RUN THE OBJECT MANIFEST
-------------------------------- --------------------------------
Every object is checked whether its type has a manifest file. If the type has Every object is checked whether its type has a executable manifest. The
a manifest file and it is executable, it will be executed. The manifest script manifest script may generate and change the created objects. In other words,
may generate and change the created objects. In other words, one type can reuse one type can reuse other types.
other types.
For instance the object __apache/www.test.ch is of type __apache, which may For instance the object __apache/www.test.ch is of type __apache, which may
contain a manifest script, which creates new objects of type __file. contain a manifest script, which creates new objects of type __file.
@ -88,11 +87,10 @@ Related documentation:
STAGE 5: CODE GENERATION STAGE 5: CODE GENERATION
------------------------ ------------------------
In this stage for every created objects its type is checked whether it has a In this stage for every created objects its type is checked for executable
gencode script. If the type has a gencode script and it is executable it will gencode whether scripts. The gencode scripts generate the code to be executed
be executed. This executable should create code to be executed on the target on the target on stdout. If the gencode executables fail, they must print
on stdout. If the gencode executable fails, it must print diagnostic messages diagnostic messages on stderr and exit non-zero.
on stderr and exit non-zero.
Related documentation: Related documentation:
- cdist-object-gencode-run(1) - cdist-object-gencode-run(1)