youri-check

Langue: en

Version: 2007-04-24 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

Sommaire

NAME

youri-check - package check agent

VERSION

Version 1.0

SYNOPSIS

youri-check [options] <test|report>

Options:

     --config <file>        use file <file> as config file
     --skip-media <media>   skip media <media>
     --skip-test <test>     skip test <test>
     --skip-report <report> skip report <report>
     --parallel             parallel run
     --verbose              verbose run
     --timestamp            add timestamps in output
     --test                 test run
     --list <category>      list items from given category
     --help                 print this help message

DESCRIPTION

youri-check allows to check packages in a repository.

In test mode, all medias defined in configuration are passed to a list of test plugins, each of them storing their result in a persistent resultset. In report mode, this resultset is passed to a list of report plugins, each of them producing arbitrary effects.

In normal run, all tests or reports are processed sequentially, whereas they are processed simultaneously in parallel run (using --parallel option). The second one is faster, but generally more expensive in term of memory usage, even if parsed headers caching is automatically desactivated. Also, some configurations (such as the use of sqlite as result database) are not compatible with parallel mode.

OPTIONS

--config <file>
Use given file as configuration, instead of normal one.
--skip-media <media>
Skip media with given identity.
--skip-test <test>
Skip test with given identity.
--skip-report <report>
Skip report with given identity.
--parallel
Run all plugins parallelously
--verbose
Produce more verbose output (can be used more than once)
--timestamp
Add timestamps in output.
--test
Don't perform any modification.
--list category
List available items from given category and exits. Category must be either medias.
--help
Print a brief help message and exits.

CONFIGURATION

Configuration is read from the first file found among:
* the one specified by --config option on command-line
* $HOME/.youri/check.conf
* /etc/youri/check.conf

The configuration file should be a YAML-format files, with the following mandatory top-level directives:

resultset
The definition of the resultset plugin to be used.
medias
The list of available media plugins, indexed by their identity.
tests
The list of available test plugins, indexed by their identity.
reports
The list of available report plugins, indexed by their identity.

Additional optional top-level directives:

netconfig
libnet configuration options (see Net::Config).
resolver
The definition of the resolver plugin to be used.
preferences
The definition of the preferences plugin to be used.

Here is a sample configuration:

     # Use a local sqlite database for storing results
     resultset:
         class: Youri::Check::Resultset::DBI
         options:
             driver: sqlite
             base: youri
 
 

     # Test packages older than 12 months
     checks:
         age:
             class: Youri::Check::Test::Age
             options:
                 max: 12 months
                 pattern: %m months
 
 

     # Reports results as HTML files
     reports:
         file:
             class: Youri::Check::Report::File
             options:
                 to: ${home}/youri
                 global: 1
                 individual: 1
                 formats:
                     html:
                         class: Youri::Check::Report::File::Format::HTML
 
 

     # Test PLF free media for cooker/i586
     medias:
         free:
             class: Youri::Media::URPM
             options:
                 name: free
                 type: binary
                 hdlist: ftp://ftp.free.fr/pub/Distributions_Linux/plf/mandriva/cooker/free/binary/i586/hdlist.cz

See commented configuration files in the distribution for more complex examples.

SEE ALSO

Youri::Config, for additional details about configuration file format.

Each used plugin man page, for available options.

Copyright (C) 2002-2006, YOURI project

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.