Linux Certif

Toute la documentation sur la certification Linux LPI

urpmc

NAME

urpmc - user rpm change(s|log) i.e. outputs a list of packages to be updated from a urpmi medium and the changes made to them.

SYNOPSIS

urpmc [options] [media]

   Options:
     --changelog              Output changelog data <defaults on>.
     --compact                Group packages together by identical
                              changelogs <defaults on>.
     --curl                   Use curl to update the hdlist files.
     -f                       Print version, release and arch of each
                              package listed.
     --help -h -?             Brief help message.
     --ignore                 Ignore the medium given. 
     --man                    Full documentation.
     -n                       Number of changelog entries to show
                              <default = 1>.
     --nameonly               Don't print the version/release on packages
                              just the name.
     --nochangelog            Do not output changelog data.
     --nocompact              Do not group packages by identical
                              changelogs.
     --noshowcurrent --nosc   Do not show the currently installed version.
     --notocurrent --notc     Do not show changelog to current installed
                              version.
     --noupdatemedia --noum   Don't run uprmi.update.
                              <defaults on for non-root users>.
     --proxy                  Use specified HTTP proxy.
     --proxyuser              Specify user and pass to use for proxy.
     --showcurrent --sc       Show the currently installed version
                              <defaults on>.
     --tocurrent --tc         List changelog up to currently installed
                              version. <defaults on>
     --update                 Uses all media flagged with the update flag.
     --updatemedia --um       Run urpmi.update.
                              <defaults on for root user>.
     --verbose -v             Show output of all commands.
     --version -V             Show the version of updatelist
     --wget                   Use wget to update the hdlist files.
 
 

OPTIONS

--changelog

Output changelog data. Defaults on.

--compact

Group packages together by identical changelogs. This makes it easier to see packages that are produced by one SRPM and always get updated together. Defaults on.

--curl

Use curl to update the hdlist files. This is really just a pass through to urpmi.update. See the uprmi.update man page for details.

-f

Print version, release and arch of each packages listed. Same as in urpmq.

--help -h -?

Brief help message.

--ignore

Ignores the given medium, useful for when run with no args and you don't want to see the output from a specific medium.

--man

Full documentation.

-n

Number of changelog entries to show. Passing 0 is equivalent to using the --nochangelog option. Defaults to 1.

--nameonly

Don't print the version/release on packages just the name. This option implicitly disables --showcurrent or --sc.

--nochangelog

Do not output changelog data. Similar to urpmq standard output. The benefit here is we run the urpmi.update command and don't output anything when doing it.

--nocompact

Do not group packages by identical changelogs. Meaning even if they have duplicate changelogs we'll print each package and its changelog.

--noshowcurrent --nosc

Doesn't show the current installed version. If you want to use the --nameonly option you must use this option.

--notocurrent --notc

Doesn't show the changelog to the currently installed version, but rather only shows the number of changelog entries per package as specified by the -n option (or the default of 1 if -n is not specified).

--noupdatemedia --noum

Don't run uprmi.update. Defaults on for non-root users.

--proxy

Use specified HTTP proxy. This is just a passthrough to urpmi.update, see the urpmi.update man page for details.

--proxyuser

Specify user and pass to use for proxy. This is just a passthrough to urpmi.update, see the urpmi.update man page for details.

--showcurrent --sc

Show the currently installed version. Tied to the --nameonly option. If you use this option --nameonly is unset. Defaults on.

--tocurrent --tc

List changelog up to currently installed version. It does this by getting the version of the source rpm that built the currently installed version. This should allow reliable limiting to the changes since what you have installed. There are a few exceptions. Obviously if the package isn't already installed you will get the full changelog. If the package doesn't have the changelog for the version you have intalled you will also get the packages entire changelog. This can happen if the changelog has been truncated. Defaults on.

--update

Selects the media flagged with the update flag in the urpmi.cfg. This can be done when adding it by urpmi.addmedia with --update or by editing the urpmi.cfg.

--updatemedia --us

Run urpmi.update. Defaults on for root user.

--verbose -v

Show more output including the commands run and their output. Primarily useful for debugging.

--version -V

Show the version of urpmc

-wget

Use wget to update the hdlist files. This is really just a pass through to urpmi.update. See the uprmi.update man page for details.

DESCRIPTION

urpmc will run urpmi.update on a medium or media, get the list of packages that an auto-select would install, and show the changelogs of those packages from the hdlist.

If you do not pass any media names or the --update option it will use all media that are defined but not disabled/ignored.

If any of the selected media do not have a hdlist available then only the names of changed packages will be printed.

If you pass conflicting options the last option on the command line will be the one used. For example if you pass, --notc --tc, --tc would be used.

This program should be suitable for adding to a cronjob so you can see what updates you need to install and why. Especially useful for cooker developers so they can see what changes they are installing, not just the package names.

PREREQUISITES

This script requires the "strict" module, "warnings" module, "sigtrap" module, "urpm" module, "URPM" module, "Getopt::Long" module, "Pod::Usage" module, "packdrake" module, "POSIX" module, "File::Temp" module.

TO DO

* Possibly add the option to actually install the pacakges if being run interactively.

* Deal with making sure it gets the headers from the right medium if two media have the same file.

AUTHOR

Ben Reser <ben@reser.org>

SPECIAL THANKS

trappist for proofing my documentation and beta testing. vdanen and Grimau also for beta testing.

COPYRIGHT

Copyright (c) 2003 Ben Reser <ben@reser.org>

Licensed under the GPL. Please see COPYING for details.