yum-groups-manager(1)
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 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.
- 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-inenglish.
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://linux.duke.edu/yum/
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).