mdvsys

Langue: en

Version: 2008-02-15 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

mdvsys - Mandriva build system command line client

SYNOPSIS

mdvsys <action> [options]...

Actions:

     import        import packages into the repository
     create        create package directory into the repository
     checkout|co   checkout package into a working directory
     update        update package into repository
     mass-update   update all packages with available version
     info          get package information from repository
     log           get package changelog from repository
     tag           tag package into repository
     extract       extract source package from repository
     submit        submit package from repository
     sync          sync working directory content
     commit|ci     commit working directory content
     build         build package from working directory
     strip         strip package changelog from working directory
     help          display this help message
 
 

DESCRIPTION

This tool is an alternative to repsys and bm to manage packages in Mandriva build system, allowing to perform different actions on packages.

Most actions implements a single part of the package release cycle. For instance, the standard sequences of actions for updating a package already imported into the subversion repository is:

mdvsys checkout
manual modifications
mdvsys build
mdvsys sync
mdvsys commit
mdvsys submit

Other actions, tough, cover the whole update cycle of a single package, such as mdvsys update. And even the update cycle of several packages at once, such as mdvsys mass-update.

The default verbosity level for each action correspond to minimal feedback output, and mask underlying details. Cumulative verbose flags can be used to raise verbosity level.

Configuration relies on repsys configuration files:

the system configuration file is given through the --config flag, and defaults to /etc/repsys.conf
the personal configuration file is given through the REPSYS_CONF environment variable, and defaults to ~/.repsys/repsys.conf

The system configuration is read first, and the personal configuration file thereafter, overriding previous settings.

More details about each individual actions follow.

ACTIONS


IMPORT

mdvsys import [options] <file1> [[file2] ...]

Options:

     --verbose,-v         increase verbosity level (cumulative) (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --message <message>  use given message as commit message
     --nocommit           disable commit action
     --help,-h            display this help message
 
 

Import one or more source package into the subversion repository.

CREATE

mdvsys create [options] <package>

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --message <message>  use given message as commit message
     --nocommit           disable commit action
     --help,-h            display this help message
 
 

Create a package directory in the subversion repository.

CHECKOUT

mdvsys checkout [options] <package> [dir]

mdvsys co [options] <package> [dir]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --help,-h            display this help message
 
 

Checkout the current version of a package from the subversion repository. If no directory name is provided, the package name is used instead.

UPDATE

mdvsys update [options] <package> [version]

Options:

     --verbose,-v                        increase verbosity level (cumulative)
     --config,-c <file>                  use given configuration file
     --revision <rev>                    use given revision in repository
     --distribution <dis>                use given distribution tree in repository
     --branch <branch>                   use given package branch in repository
     --release <release>                 pass to updater object
     --spec-line-expression <expression> pass to updater object
     --keep-on-failure                   keep temporary directory on failure
     --message <message>                 use given message as commit message
     --target <target>                   use given submission target
     --nocommit                          disable commit action
     --nosubmit                          disable submit action
     --help,-h                           display this help message
 
 

Checkout a package to a temporary directory, update it to either a new version if a version number is given or to a new release, then submit it. See Youri::Package::RPM::Updater for specific options description.

MASS-UPDATE

mdvsys mass-update [options] <url>

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --include <regexp>   only process packages matching given regexp
     --exclude <regexp>   don't process packages matching given regexp
     --keep-on-failure    keep temporary directories on failure
     --nocommit           disable commit action
     --nosubmit           disable submit action
     --help,-h            display this help message
 
 

Fetch a youri-check available update report at given URL, and try to update each package for which a new version is available.

INFO

mdvsys info [options] [package]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --help,-h            display this help message
 
 

Give informations about a package from subversion repository. If no package name is provided, the one from the current directory is used.

LOG

mdvsys log [options] [package]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --help,-h            display this help message
 
 

Generate the changelog of a package from subversion repository. If no package name is provided, the one from the current directory is used.

TAG

mdvsys tag [options] [package]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --help,-h            display this help message
 
 

Tag package in subversion repository. If no package name is provided, the one from the current directory is used.

SUBMIT

mdvsys submit [options] [package]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --target <target>    use given submission target
     --define <value>     pass --define <value> to underlying command
     --help,-h            display this help message
 
 

Submit a package from subversion repository to the build system. If no package name is provided, the one from the current directory is used.

EXTRACT

mdvsys extract [options] [package]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --revision <rev>     use given revision in repository
     --distribution <dis> use given distribution tree in repository
     --branch <branch>    use given package branch in repository
     --destdir            use given directory as destination
     --prefix             add prefix for mandriva submission tool
     --help,-h            display this help message
 
 

Extract a source package from the subversion repository into the current directory. The --prefix options make it compatible with mandriva submission tool. If no package name is provided, the one from the current directory is used.

SYNC

mdvsys sync [options] [dir]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --help,-h            display this help message
 
 

Ensure content from a working directory content is synchronized with subversion repository, by adding new sources and patches referenced in the spec file, and removing old ones. If no directory name is provided, the current one is used.

COMMIT

mdvsys commit [options] [dir]

mdvsys ci [options] [dir]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --sync               perform sync action before commiting
     --message <message>  use given message as commit message
     --help,-h            display this help message
 
 

Commit content from a working directory content. If no directory name is provided, the current one is used.

BUILD

mdvsys build [options] [file]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --define <value>     pass --define <value> to underlying command
     --help,-h            display this help message
 
 

Build package with given spec file. If no spec file is provided, the one from the current directory is used.

STRIP

mdvsys strip [options] [file]

Options:

     --verbose,-v         increase verbosity level (cumulative)
     --config,-c <file>   use given configuration file
     --help,-h            display this help message
 
 

Remove the changelog of the spec file. If no spec file is provided, the one from the current directory is used.

CHANGES

The 2.0 branches introduces many changes, renaming some actions for consistency, and changing behaviour of others for sake of isolation. Here is a list of changes:
action getsrpm has been renamed to extract
action extract doesn't prefix generated package by default, you have to use --prefix option
action commit doesn't check for unsync content now, it just commit changes

Verbosity has also been altered in order to be able to use actions with large scope, such as mass-update without getting drowned under individual package build details. The default verbosity is minimal feedback for each action, and can be gradually increased using cumulative --verbose flags.

AUTHORS

Olivier Thauvin <nanardon@mandriva.org>

Guillaume Rousse <guillomovitch@mandriva.org>

MichaA~Xl Scherer <misc@mandriva.org>

SEE ALSO

repsys