yum-groups-manager
Section: (1)
Updated: 2008 Aug 23
Index
Return to Main Contents
NAME
yum-groups-manager - create and edit yum's group metadata
SYNOPSIS
yum-groups-manager [options] [packages]
DESCRIPTION
yum-groups-manager is used to create or edit a group metadata file for a
yum repository. This is often much easier than writting/editing the XML by hand.
The yum-groups-manager can load an entire file of groups metadata and
either create a new group or edit an existing group and then write all of the
groups metadata back out.
OPTIONS
- -h, --help
-
Display a help message, and then quit.
- --version
-
Display a version message, and then quit.
- -n, --name
-
The name to lookup/use for the group. If you specify an existing group id, then
the group with that id will have it's name changed to this value.
- --id
-
The id to lookup/use for the group. If you don't specify an id, but do specify a
name that doesn't refer to an existing group, then an id for the group is
generated based on the name.
- --description
-
The description to use for the group.
- --mandatory
-
Store the package names specified within the mandatory section of the specified
group, the default is to use the default section. This overrides the optional
argument.
- --optional
-
Store the package names specified within the optional section of the specified
group, the default is to use the default section. This option is overridden by
the mandatory argument.
- --dependencies
-
Also include the names of the direct dependencies for each package specified.
- --not-user-visible
-
Make the group not visible in yum grouplist.
- --user-visible
-
Make the group visible in yum grouplist (this is the default).
- --display-order
-
Change the integer which controls the order groups are presented in, for example
in yum grouplist.
- --load
-
Load the groups metadata information from the specified file, before
performing any operataions. This option can be specified multiple times.
- --save
-
Save the result to this file, you can specify the name of a file you are
loading from as the data will only be saved when all the operations have been
performed. This option can also be specified multiple times.
- --merge
-
This is the same as loading and saving a file, however the "merge" file is
loaded before any others and saved last.
- --print
-
Also print the result to stdout, if saving or merging.
- --remove
-
Instead of adding package, remove them. Note that the packages are removed from
all sections (default, mandatory and optional).
- --translated-name
-
This is another name for the group within the locale given. The syntax is
lang:text. Eg. en:my-group-name-in-english
- --translated-description
-
This is another description for the group within the locale given. The syntax is
lang:text. Eg. en:my-group-description-in-english.
YUM OPTIONS
The following options are meant to be the same as those with the same name
in yum.
- -c CONFIG, --config=CONFIG
-
- --quiet
-
- --verbose
-
- --enablerepo
-
- --disablerepo
-
- --noplugins
-
- -C, --cache
-
- --tempcache
-
EXAMPLES
- Create a new group metadata file, with a group called yum containing all the packages that start with yum:
-
yum-groups-manager --name YUM --save groups.xml 'yum*'
- After the above command, load the groups.xml data, work with the yum group, make the group not user visible, and remove the yum-skip-broken and yum-priorities packages from it:
-
yum-groups-manager -n YUM --merge groups.xml --remove yum-skip-broken yum-priorities --not-user-visible
- After the above commands, add a description and a translated name to the yum group:
-
yum-groups-manager -n YUM --merge groups.xml --description 'This is a group with most of the yum packages in it' --translated-name 'en:yum packages'
FILES
yum-groups-manager uses the yum libraries for retrieving information and
packages. If no configuration file is specified, the default yum
configuration will be used.
/etc/yum.conf
/etc/yum/repos.d/
SEE ALSO
yum (8)
yum.conf (5)
http://yum.baseurl.org/
AUTHORS
See the Authors file included with this program.
BUGS
There are a couple of options you can't set, yet. Most notabley you cannot put
package names into the conditional section (where they are installed with
groupinstall only if another package is installed).