|
 |
4c79b5 |
|
|
|
4c79b5 |
<html>
|
|
|
6414c4 |
|
|
|
09d4f2 |
|
|
|
6414c4 |
Copyright C 2009, 2010, 2011 Alain Reguera Delgado
|
|
|
4c79b5 |
|
|
|
4c79b5 |
Permission is granted to copy, distribute and/or modify this document
|
|
|
4c79b5 |
under the terms of the GNU Free Documentation License, Version 1.2 or
|
|
|
4c79b5 |
any later version published by the Free Software Foundation; with no
|
|
|
4c79b5 |
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
|
|
|
4c79b5 |
copy of the license is included in the section entitled GNU Free
|
|
|
4c79b5 |
Documentation License.
|
|
|
4c79b5 |
-->
|
|
|
6414c4 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
|
|
|
4c79b5 |
Karl Berry <karl@freefriends.org>
|
|
|
4c79b5 |
Olaf Bachmann <obachman@mathematik.uni-kl.de>
|
|
|
4c79b5 |
and many others.
|
|
|
4c79b5 |
Maintained by: Many creative people <dev@texi2html.cvshome.org>
|
|
|
4c79b5 |
Send bugs and suggestions to <users@texi2html.cvshome.org>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
-->
|
|
|
4c79b5 |
<head>
|
|
|
280c77 |
<title>The CentOS Artwork Repository: 3.37 trunk/Scripts/Bash</title>
|
|
|
4c79b5 |
|
|
|
280c77 |
<meta name="description" content="The CentOS Artwork Repository: 3.37 trunk/Scripts/Bash">
|
|
|
280c77 |
<meta name="keywords" content="The CentOS Artwork Repository: 3.37 trunk/Scripts/Bash">
|
|
|
4c79b5 |
<meta name="resource-type" content="document">
|
|
|
4c79b5 |
<meta name="distribution" content="global">
|
|
|
4c79b5 |
<meta name="Generator" content="texi2html 1.76">
|
|
|
4c79b5 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
|
4c79b5 |
<style type="text/css">
|
|
|
4c79b5 |
|
|
|
1e9202 |
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
|
|
|
4c79b5 |
|
|
|
4c79b5 |
a.summary-letter {text-decoration: none}
|
|
|
4c79b5 |
pre.display {font-family: serif}
|
|
|
4c79b5 |
pre.format {font-family: serif}
|
|
|
4c79b5 |
pre.menu-comment {font-family: serif}
|
|
|
4c79b5 |
pre.menu-preformatted {font-family: serif}
|
|
|
4c79b5 |
pre.smalldisplay {font-family: serif; font-size: smaller}
|
|
|
4c79b5 |
pre.smallexample {font-size: smaller}
|
|
|
4c79b5 |
pre.smallformat {font-family: serif; font-size: smaller}
|
|
|
4c79b5 |
pre.smalllisp {font-size: smaller}
|
|
|
4c79b5 |
span.sansserif {font-family:sans-serif; font-weight:normal;}
|
|
|
4c79b5 |
ul.toc {list-style: none}
|
|
|
4c79b5 |
-->
|
|
|
4c79b5 |
</style>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
</head>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
01b527 |
[ < ]
|
|
|
01b527 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
4c79b5 |
[ Up ]
|
|
|
280c77 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[Top]
|
|
|
4c79b5 |
[Contents]
|
|
|
280c77 |
[Index]
|
|
|
4c79b5 |
[ ? ]
|
|
|
4c79b5 |
|
|
|
280c77 |
|
|
|
01b527 |
|
|
|
280c77 |
3.37 trunk/Scripts/Bash
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
01b527 |
|
|
|
6ba043 |
3.37.1 Goals
|
|
|
6ba043 |
|
|
|
280c77 |
The <tt>`trunk/Scripts/Bash'</tt> directory exists to organize the trunk
|
|
|
280c77 |
development line of <tt>`centos-art.sh'</tt> automation script. The
|
|
|
280c77 |
<tt>`centos-art.sh'</tt> script standardizes frequent tasks inside your
|
|
|
280c77 |
working copy of CentOS Artwork Repository.
|
|
|
54b5a5 |
|
|
|
6ba043 |
|
|
|
01b527 |
|
|
|
6ba043 |
3.37.2 Description
|
|
|
6ba043 |
|
|
|
280c77 |
The best way to understand <tt>`centos-art.sh'</tt> automation script is
|
|
|
280c77 |
studying its source code. However, as start point, you may prefer to
|
|
|
280c77 |
read an introductory resume before diving into the source code
|
|
|
280c77 |
details.
|
|
|
280c77 |
|
|
|
280c77 |
The <tt>`centos-art.sh'</tt> script is written in Bash. Most tasks, inside
|
|
|
280c77 |
<tt>`centos-art.sh'</tt> script, have been organized in many specific
|
|
|
280c77 |
functionalities that you can invoke from the centos-art
|
|
|
280c77 |
command-line interface.
|
|
|
280c77 |
|
|
|
280c77 |
When you type the centos-art command in your terminal, the
|
|
|
280c77 |
operating system trys to execute that command. In order to execute the
|
|
|
280c77 |
command, the operating system needs to know where it is, so the
|
|
|
280c77 |
operating system uses the PATH environment variable to look for
|
|
|
280c77 |
that command's location. If your system was prepared to use CentOS
|
|
|
280c77 |
Artwork Repository correctly (see section trunk/Scripts/Bash/Functions/Verify), you should have a symbolic link inside <tt>`~/bin/'</tt>
|
|
|
280c77 |
directory that points to the <tt>`centos-art.sh'</tt> script file. As
|
|
|
280c77 |
<tt>`~/bin/'</tt> directory is, by default, inside PATH environment
|
|
|
280c77 |
variable, the execution of centos-art command runs the
|
|
|
63f275 |
<tt>`centos-art.sh'</tt> script.
|
|
|
63f275 |
|
|
|
280c77 |
When <tt>`centos-art.sh'</tt> script is executed, the first it does is
|
|
|
280c77 |
executing the <tt>`trunk/Scripts/Bash/initEnvironment.sh'</tt> script to
|
|
|
280c77 |
initialize global variables (e.g., gettext's variables) and
|
|
|
280c77 |
global function scripts. Global function scripts are located inside
|
|
|
280c77 |
<tt>`trunk/Scripts/Bash/Functions'</tt> directory and their file names
|
|
|
280c77 |
begin with <samp>`cli'</samp>. Global function scripts provide common
|
|
|
280c77 |
functionalities that can be used anywhere inside <tt>`centos-art.sh'</tt>
|
|
|
280c77 |
script execution environment.
|
|
|
280c77 |
|
|
|
280c77 |
Once global variables and function scripts have been loaded,
|
|
|
280c77 |
<tt>`centos-art.sh'</tt> script executes the cli global function
|
|
|
280c77 |
from <tt>`cli.sh'</tt> function script to retrive command-line arguments
|
|
|
280c77 |
and define some default values that may be used later by specific
|
|
|
280c77 |
function scripts (see section trunk/Scripts/Bash/Functions).
|
|
|
280c77 |
|
|
|
280c77 |
As convenction, the <tt>`centos-art.sh'</tt> command-line arguments have
|
|
|
280c77 |
the following format:
|
|
|
280c77 |
|
|
|
280c77 |
centos-art arg1 --arg2=val2 --arg3=val3
|
|
|
280c77 |
|
|
|
280c77 |
In the above example, <samp>`centos-art'</samp> is the command you use to
|
|
|
280c77 |
invoke <tt>`centos-art.sh'</tt> script. The <samp>`arg1'</samp> is required and
|
|
|
280c77 |
represents the functionality you want to perform (e.g.,
|
|
|
280c77 |
<samp>`verify'</samp>, <samp>`render'</samp>, <samp>`locale'</samp>, <samp>`manual'</samp>,
|
|
|
280c77 |
etc.). The remaining arguments are modifiers to <samp>`arg1'</samp>. The
|
|
|
280c77 |
<samp>`--arg2'</samp> definition is required and represets, specifically,
|
|
|
280c77 |
the action inside the functionality you want to perform. The
|
|
|
280c77 |
<samp>`--arg3'</samp> and on, are optional.
|
|
|
280c77 |
|
|
|
280c77 |
Once command-line arguments have been retrived, the
|
|
|
280c77 |
<tt>`centos-art.sh'</tt> script loads specific functionalities using the
|
|
|
280c77 |
<tt>`cli_getFunctions.sh'</tt> function script. Only one specific
|
|
|
280c77 |
functionality can be loaded at one script execution I.e., you run
|
|
|
280c77 |
centos-art.sh script to run just one functionality.
|
|
|
280c77 |
|
|
|
280c77 |
|
|
|
280c77 |
+----------------------------------------------------------------------+
|
|
|
280c77 |
| [centos@host]$ centos-art function --action='value' --option='value' |
|
|
|
280c77 |
+----------------------------------------------------------------------+
|
|
|
280c77 |
| ~/bin/centos-art --> ~/artwork/trunk/Scripts/Bash/centos-art.sh |
|
|
|
280c77 |
+---v-----------------------------------------v------------------------+
|
|
|
280c77 |
| centos-art.sh |
|
|
|
280c77 |
+---v---------------------------------v---+
|
|
|
280c77 |
. | initEnvironment.sh | .
|
|
|
280c77 |
. +---------------------------------+ .
|
|
|
280c77 |
. | cli $@ | .
|
|
|
280c77 |
. +---v-------------------------v---+ .
|
|
|
280c77 |
. . | cli_getFunctions | . .
|
|
|
280c77 |
. . +---v-----------------v---+ . .
|
|
|
280c77 |
. . . | function1 | . . .
|
|
|
280c77 |
. . . | function2 | . . .
|
|
|
280c77 |
. . . | function3 | . . .
|
|
|
280c77 |
. . . +-----------------+ . . .
|
|
|
280c77 |
. . ........................... . .
|
|
|
280c77 |
. ................................... .
|
|
|
280c77 |
...........................................
|
|
|
280c77 |
|
|
|
280c77 |
Figure 3.12: The functionalities initialization environment.
|
|
|
280c77 |
|
|
|
3207df |
|
|
|
280c77 |
Functionalities are implemented by means of actions. Once the
|
|
|
280c77 |
functionality has been initiazalized, actions initialization take
|
|
|
280c77 |
place for that functionality. Actions initialization model is very
|
|
|
280c77 |
similar to functions initialization model. But with the difference,
|
|
|
280c77 |
that actions are loaded inside function environment, and so, share
|
|
|
280c77 |
variables and functions defined inside function environment.
|
|
|
280c77 |
|
|
|
280c77 |
|
|
|
280c77 |
+--------------------------------------+
|
|
|
280c77 |
| cli_getFunctions |
|
|
|
280c77 |
+---v------------------------------v---+
|
|
|
280c77 |
. | function1 | .
|
|
|
280c77 |
. +---v----------------------v---+ .
|
|
|
280c77 |
. . | function1_getActions | . .
|
|
|
280c77 |
. . +---v--------------v---+ . .
|
|
|
280c77 |
. . . | action 1 | . . .
|
|
|
280c77 |
. . . | action 2 | . . .
|
|
|
280c77 |
. . . | action n | . . .
|
|
|
280c77 |
. . . +--------------+ . . .
|
|
|
280c77 |
. . ........................ . .
|
|
|
280c77 |
. ................................ .
|
|
|
280c77 |
. +------------------------------+ .
|
|
|
280c77 |
. | function2 | .
|
|
|
280c77 |
. +---v----------------------v---+ .
|
|
|
280c77 |
. . | function2_getActions | . .
|
|
|
280c77 |
. . +---v--------------v---+ . .
|
|
|
280c77 |
. . . | action 1 | . . .
|
|
|
280c77 |
. . . | action 2 | . . .
|
|
|
280c77 |
. . . | action n | . . .
|
|
|
280c77 |
. . . +--------------+ . . .
|
|
|
280c77 |
. . ........................ . .
|
|
|
280c77 |
. ................................ .
|
|
|
280c77 |
. +------------------------------+ .
|
|
|
280c77 |
. | function3 | .
|
|
|
280c77 |
. +---v----------------------v---+ .
|
|
|
280c77 |
. . | function3_getActions | . .
|
|
|
280c77 |
. . +---v--------------v---+ . .
|
|
|
280c77 |
. . . | action 1 | . . .
|
|
|
280c77 |
. . . | action 2 | . . .
|
|
|
280c77 |
. . . | action n | . . .
|
|
|
280c77 |
. . . +--------------+ . . .
|
|
|
280c77 |
. . ........................ . .
|
|
|
280c77 |
. ................................ .
|
|
|
280c77 |
........................................
|
|
|
280c77 |
|
|
|
280c77 |
Figure 3.13: The actions initialization environment.
|
|
|
280c77 |
|
|
|
63f275 |
|
|
|
6ba043 |
|
|
|
01b527 |
|
|
|
6ba043 |
3.37.3 Usage
|
|
|
6ba043 |
|
|
|
280c77 |
The <tt>`centos-art.sh'</tt> script usage information is described inside
|
|
|
280c77 |
each specific function documentation (see section trunk/Scripts/Bash/Functions).
|
|
|
3207df |
|
|
|
3207df |
|
|
|
280c77 |
|
|
|
3207df |
3.37.4 See also
|
|
|
3207df |
|
|
|
3207df |
|
|
|
280c77 |
3.36 trunk/Scripts
|
|
|
280c77 |
|
|
|
280c77 |
3.38 trunk/Scripts/Bash/Functions
|
|
|
63f275 |
|
|
|
280c77 |
3.48 trunk/Scripts/Bash/Locale
|
|
|
63f275 |
|
|
|
63f275 |
|
|
|
4c79b5 |
|
|
|
5fb024 |
|
|
|
4c79b5 |
|
|
|
280c77 |
[ < ]
|
|
|
280c77 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
01b527 |
[ Up ]
|
|
|
280c77 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
<font size="-1">
|
|
|
6414c4 |
This document was generated on January, 3 2011 using texi2html 1.76.
|
|
|
4c79b5 |
</font>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
</body>
|
|
|
4c79b5 |
</html>
|