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 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 AND LICENSE

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.