yum-groups-manager(1)

1yum-groups-manager(1)                                    yum-groups-manager(1)
2
3
4

NAME

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

SYNOPSIS

9       yum-groups-manager [options] [packages]
10

DESCRIPTION

12       yum-groups-manager  is used to create or edit a group metadata file for
13       a yum repository. This is often much easier than  writting/editing  the
14       XML  by hand.  The yum-groups-manager can load an entire file of groups
15       metadata and either create a new group or edit an  existing  group  and
16       then write all of the groups metadata back out.
17

OPTIONS

19       -h, --help
20              Display a help message, and then quit.
21
22       --version
23              Display a version message, and then quit.
24
25       -n, --name
26              The name to lookup/use for the group. If you specify an existing
27              group id, then the group  with  that  id  will  have  it's  name
28              changed to this value.
29
30       --id   The  id to lookup/use for the group. If you don't specify an id,
31              but do specify a name that doesn't refer to an  existing  group,
32              then an id for the group is generated based on the name.
33
34       --description
35              The description to use for the group.
36
37       --mandatory
38              Store  the  package names specified within the mandatory section
39              of the specified group, the default is to use the  default  sec‐
40              tion. This overrides the optional argument.
41
42       --optional
43              Store the package names specified within the optional section of
44              the specified group, the default is to use the default  section.
45              This option is overridden by the mandatory argument.
46
47       --dependencies
48              Also include the names of the direct dependencies for each pack‐
49              age specified.
50
51       --not-user-visible
52              Make the group not visible in yum grouplist.
53
54       --user-visible
55              Make the group visible in yum grouplist (this is the default).
56
57       --display-order
58              Change the integer which controls the order groups are presented
59              in, for example in yum grouplist.
60
61       --load Load  the  groups  metadata information from the specified file,
62              before performing any operataions. This option can be  specified
63              multiple times.
64
65       --save Save the result to this file, you can specify the name of a file
66              you are loading from as the data will only be saved when all the
67              operations  have  been performed. This option can also be speci‐
68              fied multiple times.
69
70       --merge
71              This is the same as loading  and  saving  a  file,  however  the
72              "merge" file is loaded before any others and saved last.
73
74       --print
75              Also print the result to stdout, if saving or merging.
76
77       --remove
78              Instead  of  adding package, remove them. Note that the packages
79              are removed from all sections (default, mandatory and optional).
80
81       --translated-name
82              This is another name for the group within the locale given.  The
83              syntax is lang:text. Eg. en:my-group-name-in-english
84
85       --translated-description
86              This  is  another  description  for  the group within the locale
87              given. The syntax is lang:text. Eg.  en:my-group-description-in-
88              english.
89
90

YUM OPTIONS

92       The  following  options are meant to be the same as those with the same
93       name in yum.
94
95       -c CONFIG, --config=CONFIG
96
97       --quiet
98
99       --verbose
100
101       --enablerepo
102
103       --disablerepo
104
105       --noplugins
106
107       -C, --cache
108
109       --tempcache
110
111

EXAMPLES

113       Create a new group metadata file, with a group  called  yum  containing
114       all the packages that start with yum:
115               yum-groups-manager --name YUM --save groups.xml 'yum*'
116
117       After  the  above  command, load the groups.xml data, work with the yum
118       group, make the group not user visible, and remove the  yum-skip-broken
119       and yum-priorities packages from it:
120               yum-groups-manager -n YUM --merge groups.xml --remove yum-skip-
121              broken yum-priorities --not-user-visible
122
123       After the above commands, add a description and a  translated  name  to
124       the yum group:
125               yum-groups-manager  -n  YUM  --merge  groups.xml  --description
126              'This is a group with most of the yum packages in  it'  --trans‐
127              lated-name 'en:yum packages'
128

FILES

130       yum-groups-manager  uses  the  yum libraries for retrieving information
131       and packages. If no configuration file is specified,  the  default  yum
132       configuration will be used.
133
134       /etc/yum.conf
135       /etc/yum/repos.d/
136

AUTHORS

143       See the Authors file included with this program.
144

BUGS

146       There are a couple of options you can't set, yet. Most notabley you cannot put
147       package names into the conditional section (where they are installed with
148       groupinstall only if another package is installed).
149
150       Other than that, there are no bugs, but should you find any, you should first
151       consult the FAQ section on http://yum.baseurl.org/wiki/Faq and if unsuccessful
152       in finding a resolution contact the mailing list: yum-devel@lists.baseurl.org.
153       To file a bug use http://bugzilla.redhat.com for Fedora/RHEL/Centos
154       related bugs and http://yum.baseurl.org/report for all other bugs.
155
156
157
158
159                                23 August 2008           yum-groups-manager(1)