1RPM::Specfile(3) User Contributed Perl Documentation RPM::Specfile(3)
2
6 RPM::Specfile - Perl extension for creating RPM Specfiles
7
9 use RPM::Specfile;
10
12 This is a simple module for creation of RPM Spec files. Most of the
13 methods in this module are the same name as the RPM Spec file element
14 they represent but in lower case. Furthermore the the methods are
15 divided into two groups:
16 Simple Accessors
18 These methods have the have the exact name as the element they
19 represent (in lower case). If passed no arguments return a scalar
20 representing the element. If an argument is passed they will set
21 the value of the element.
22 List Accessors
24 These methods manipulate items in the spec file that are lists
25 (e.g. the list of patches maintained by the spec file). Each
26 element that is represented by a list accessor will have at least
27 three methods associated with it.
28 · A method to directly manipulate individual members of the
30 list. These methods take as a first argument the index
31 into the list, and as a second argument the element value.
32 If no arguments are given it simply returns the list. If
33 only the index is given it returns the list member at that
34 index. If the value is also given it will set the list
35 member associated with the index.
36 · A method to push a member onto the list. Each of these
38 methods have "push_" at the begining of their name.
39 · A method to clear the list. Each of these methods have
41 "clear_" at the begining of their name.
42
44 This section describes the basic structure of an RPM Spec file and how
45 that applies to RPM::Specfile. It does not attempt to give a full
46 description of RPM Spec file syntax.
47 RPM Spec files are divided into the following sections:
49 Preamble
51 This is where the meta information for the rpm is stored, such as
52 its name version and description. Also, macro definitions are
53 generally put at the top of the preamble. The methods that are
54 used to create this section are listed below:
55 buildarch(), buildrequire(), buildrequires(), buildroot(),
57 clear_buildrequire(), clear_changelog(), clear_patch(), clear_prefix(),
58 clear_provide(), clear_require(), clear_source(), description(), distribution(),
59 epoch(), group(), license(), macros(), name(), packager(), patch(), prefix(),
60 provide(), push_buildrequire(), push_patch(), push_prefix(), push_provide(),
61 push_require(), push_source(), release(), require(), requires(), source(),
62 summary(), url(), vendor(), version()
63 Many of the elements of the Preamble are required. See Maximum RPM
65 for documentation on which one are required and which ones are not.
66 Build Scriptlets
68 When rpms are built the install scriptlets are invoked. These
69 install scriptlets are %prep, %build, %install, and %clean. The
70 contents of these scripts can be set with the following methods:
71 build(), clean(), install(), prep()
73 The %prep, %build, and %install scriptlets are required, but may be
75 null.
76 Install/Erase Scriplets
78 When an RPM is installed or erased various scriplets may be
79 invoked. These scriplets can be set via the following methods:
80 post(), postun(), pre(), preun()
82 The install scriptlets are not required.
84 Files
86 The %files section is used to define what files should be delivered
87 to the system. It further defines what the permsisions and
88 ownership of the files should be. The methods that work with the
89 %files sections are:
90 file(), push_file(), clear_file(), file_param()
92 Note, a files section is required, but it may contain no entries.
94 Change Log
96 The last section in the spec file is the change log. Methods to
97 modify this are:
98 add_changelog_entry(), changelog(), push_changelog(), clear_changelog()
100 EXPORT
102 None by default.
103
105 build
106 Not sure what this one does.
107 buildarch([$arch])
109 Returns the build arch. If $arch is given will set build arch to
110 $arch.
111 $spec->buildarch('noarch');
113 buildrequire([$index, $requirement])
115 Returns a list of build requirement entries. If $index and
116 $requirement are provided, it will set the entry referenced by
117 $index to $requirement.
118 @buildRequires = $spec->buildrequire();
120 buildrequires([$requirement])
122 Returns the build requires. If $requirement is given, will set
123 build requires line to $requirement.
124 $spec->buildrequires('noarch');
126 buildroot([$root])
128 Returns the build root (this is where rpm will build the package).
129 If $root is given, will set the build root to $root.
130 $spec->buildroot('/tmp/%{name}-%{version}-%{release}');
132 clean([$scriptlet])
134 Returns the %clean scriptlet. If $scriptlet is given, will make
135 the contents of $scriptlet the %clean scriptlet.
136 $spec->clean('rm -rf $RPM_BUILD_ROOT');
138 changelog([$index, $entry])
140 Returns a list of changelog entries. If $index and $entry are
141 provided it will set the entry referenced by $index to $entry.
142 @entries = $spec->changelog();
144 clear_buildrequire()
146 Clears the build requirement list.
147 $spec->clear_buildrequire();
149 clear_changelog()
151 Clears the list of changelog entries.
152 $spec->clear_changelog();
154 clear_file()
156 Clears the file list.
157 $spec->clear_file();
159 clear_patch()
161 Clears the patch list.
162 $spec->clear_patch();
164 clear_prefix()
166 Clears the prefix list.
167 $spec->clear_prefix();
169 clear_provide()
171 Clears the list of provisions.
172 $spec->clear_provide();
174 clear_require()
176 Clears the requirements list.
177 $spec->clear_require();
179 clear_source()
181 Clears the list of sources.
182 $spec->clear_source();
184 description([$desc])
186 Returns the description of the rpm. If $desc is given, sets the
187 description of the rpm.
188 $spec->description('An automatically generated RPM');
190 distribution([$distro])
192 Returns the distribution of the rpm. If $distro is given, sets the
193 distribution of the rpm.
194 $spec->distribution('RedHat');
196 epoch([$epoch])
198 Returns the epoch of the rpm. If $epoch is given sets the epoch of
199 the rpm to $epoch.
200 $spec->epoch('0');
202 file([$index, $file])
204 Returns a list of %file entries. If $index and $file are provided,
205 it will set the entry referenced by $index to $file.
206 @files = $spec->file();
208 file_param([$param])
210 Returns the parameters to add to the %files macro invocation. If
211 $param is given, $param will be appended to the %files macro.
212 $spec->file_param('-f file_list');
214 group([$group])
216 Returns the group in which the rpm belongs. If $group is given,
217 group will be set to $group.
218 $spec->group("Development/Libraries");
220 install([$scriptlet])
222 Returns the %install scriptlet. If $scriptlet is given, the
223 %install scriptlet will be set to this.
224 $spec->group('mkdir -p $RPM_BUILD_ROOT/usr/local/mypkg');
226 license([$license])
228 Returns the type of license the rpm is will be released under. If
229 $license is given, license will be set to $license.
230 macros([$macro_defs])
232 Returns the macro definitions that are before the preamble of the
233 specfile. If $macro_defs is given, the macro definitions will be
234 set to it.
235 $spec->macros("%define x 1\n%define y 2");
237 name([$name])
239 Returns the name of the rpm. If $name is given, the name is set to
240 $name.
241 $spec->name('perl-RPM-Specfile');
243 packager([$packager])
245 Returns the email address of the packager. If $packager is set,
246 packager is set to $packager.
247 $spec->packager('someone@some.where');
249 patch([$index, $patch])
251 Returns a list of patches. If $index and $patch are provided it
252 will set the entry referenced by $index to $patch.
253 @patches = $spec->patch();
255 post([$scriptlet])
257 Returns the contents of the %post scriptlet. If $scriptlet is
258 given, %post is set to the value of $scriptlet.
259 $spec->post("echo Running %%post...\nexit 0");
261 postun([$scriptlet])
263 Returns the contents of the %postun scriptlet. If $scriptlet is
264 given, %postun is set to the value of $scriptlet.
265 $spec->postun("echo Running %%postun...\nexit 0");
267 pre([$scriptlet])
269 Returns the contents of the %pre scriptlet. If $scriptlet is
270 given, %pre is set to the value of $scriptlet.
271 $spec->pre("echo Running %%pre...\nexit 0");
273 prefix([$index, $prefix])
275 Returns a list of prefix/relocation entries. If $index and $prefix
276 are provided it will set the entry referenced by $index to $prefix.
277 @prefixes = $spec->prefix();
279 preun([$scriptlet])
281 Returns the contents of the %preun scriptlet. If $scriptlet is
282 given, %preun is set to the value of $scriptlet.
283 $spec->preun("echo Running %%preun...\nexit 0");
285 prep([$scriptlet])
287 Returns the contents of the %prep scriptlet. If $scriptlet is
288 given, %prep is set to the value of $scriptlet.
289 $spec->prep("echo Running %%prep...\nexit 0");
291 provide([$index, $provision])
293 Returns a list of provision entries. If $index and $provision are
294 provided it will set the entry referenced by $index to $provision.
295 @provides = $spec->provide();
297 push_buildrequire([$entry])
299 Push a build requirement onto the list of build requirments.
300 $spec->push_buildrequire('gcc >= 3.2');
302 push_changelog([$entry])
304 Pushes a changelog entry onto the list of changelog entries.
305 push_file([$entry])
307 Pushes a file onto the list of files.
308 $spec->push_file('%attr(0664, root, root) %dir /usr/local/mypkg');
310 $spec->push_file('%attr(0664, root, root) /usr/local/mypkg/myfile');
311 push_patch([$entry])
313 Pushes a patch onto the list of patches.
314 $spec->push_patch('autorollback.patch');
316 Note, adding a patch implicitly adds entries to the %prep script.
318 push_prefix([$prefix])
320 Push a prefix onto to the list of valid relocations.
321 $spec->clear_prefix('/usr/local/mypkg');
323 push_provide([$entry])
325 Pushes a provision onto the list of provisions.
326 $spec->push_provide('kernel-tools = 2.6');
328 push_require([$entry])
330 Pushes a requirement onto the list of requirements.
331 $spec->push_require('perl(RPM::Specfile)');
333 push_source([$entry])
335 Pushes a source entry onto the list of sources.
336 $spec->push_source('wget-1.8.2.tar.gz');
338 release([$release])
340 Returns the release of the rpm. If $release is specified, release
341 is set to $release.
342 $spec->release('1.1');
344 require([$index, $requirement])
346 Returns a list of requirement entries. If $index and $requirement
347 are provided it will set the entry referenced by $index to
348 $requirement.
349 @requires = $spec->require();
351 requires([$requires])
353 Returns the value of the Requires line. If $requires is set, the
354 Requires line will be set to $requires.
355 $spec->requires('xdelta > 0:1.1.3-11, vlock > 0:1.3-13');
357 source([$index, $source])
359 Returns a list of source entries. If $index and $source are
360 provided it will set the entry referenced by $index to $source.
361 @sources = $spec->source();
363 summary([$summary])
365 Returns the value of the Summary line. If $summary is set, the
366 Summary line will be set to $summary.
367 url([$url])
369 Returns the url of the rpm. If $usr is set, the url is set to
370 $url.
371 $spec->url('http://www.cpan.org');
373 vendor([$vendor])
375 Returns the vendor of the rpm. If $vendor is set, the vendor is
376 set to $vendor.
377 $spec->vendor('Perfect Distro, Inc.');
379 version([$version])
381 Returns the version of the rpm. If $version is set, the version is
382 set to $version.
383 new Constructor of an RPM::Specfile object.
385 $spec = RPM::Specfile->new();
387 add_changelog_entry($who, $entry, $version)
389 Adds an entry to the change log. $who should be set to something
390 like:
391 your name<your_email@somewhere.com>
393 $entry is the list of changes, and $version is the version to which
395 the change log applies.
396 $spec->add_changelog('John Smith <jsmith@smiths.com>',
398 '- Added a great bit of functionality',
399 '1.0');
400 This method will automatically generate the time of the entry.
402 generate_specfile()
404 Generates the specfile and returns it as a scalar.
405 write_specfile($file)
407 Writes specfile to $file.
408
410 A good example of the use of RPM::Specfile is cpanflute2 which comes
411 with the RPM::Specfile cpan archive.
412
414 Chip Turner <cturner@pattern.net>
415
417 This module is distributed under the same terms as Perl itself:
418 http://dev.perl.org/licenses/
420
422 perl cpanflute2 Maximum RPM (http://www.rpm.org/max-rpm/)
423
425 Hey! The above document had some coding errors, which are explained
426 below:
427 Around line 379:
429 '=item' outside of any '=over'
430 Around line 727:
432 You forgot a '=back' before '=head1'
433perl v5.12.0 2006-09-24 RPM::Specfile(3)