yum-groups-manager(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | YUM OPTIONS | EXAMPLES | FILES | SEE ALSO | AUTHORS | BUGS | COLOPHON

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.

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

       --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         top

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

       /etc/yum.conf
       /etc/yum/repos.d/

SEE ALSO         top

       yum(8)
       yum.conf(5)
       http://yum.baseurl.org/

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 http://yum.baseurl.org/wiki/Faq and if unsuccessful
       in finding a resolution contact the mailing list: [email protected].
       To file a bug use http://bugzilla.redhat.com for Fedora/RHEL/Centos
       related bugs and http://yum.baseurl.org/report 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 ⟨https://github.com/rpm-software-management/yum⟩.  It is not
       known how to report bugs for this man page; if you know, please
       send a mail to [email protected].  This page was obtained from
       the project's upstream Git repository
       ⟨https://github.com/rpm-software-management/yum-utils.git⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2020-03-11.)  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 to [email protected]

                             23 August 2008        yum-groups-manager(1)

Pages that refer to this page: yum-utils(1)