yum-groups-manager(1)                                  yum-groups-manager(1)

NAME         top

       yum-groups-manager - create and edit yum's group metadata

SYNOPSIS         top

       yum-groups-manager [options] [packages]

DESCRIPTION         top

       yum-groups-manager is used to create or edit a group metadata file
       for a yum repository. This is often much easier than writing/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         top

       -h, --help
              Display a help message, and then quit.

              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

              The description to use for the group.

              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.

              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.

              Also include the names of the direct dependencies for each
              package specified.

              Make the group not visible in yum grouplist.

              Make the group visible in yum grouplist (this is the default).

              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 operations. 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.

              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.

              Instead of adding package, remove them. Note that the packages
              are removed from all sections (default, mandatory and

              This is another name for the group within the locale given.
              The syntax is lang:text. Eg. en:my-group-name-in-english

              This is another description for the group within the locale
              given. The syntax is lang:text. Eg. en:my-group-description-

YUM OPTIONS         top

       The following options are meant to be the same as those with the same
       name in yum.

       -c CONFIG, --config=CONFIG






       -C, --cache


EXAMPLES         top

       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         top

       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.


SEE ALSO         top


AUTHORS         top

       See the Authors file included with this program.

BUGS         top

       There are a couple of options you can't set, yet. Most notably you cannot put
       package names into the conditional section (where they are installed with
       groupinstall only if another package is installed).

       Other than that, there are no bugs, but should you find any, you should first
       consult the FAQ section on and if unsuccessful
       in finding a resolution contact the mailing list:
       To file a bug use for Fedora/RHEL/Centos
       related bugs and for all other bugs.

COLOPHON         top

       This page is part of the yum-utils (Yum Package Manager utilities)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this manual
       page, see ⟨⟩.  This page was obtained
       from the project's upstream Git repository 
       ⟨git://⟩ on 2017-03-13.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

                               23 August 2008          yum-groups-manager(1)