The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

build-schedule - build a schedule for link checking.

SYNOPSIS

  build-schedule [options]

   -V --version            Give version information for this program
   -h --help --usage       Describe usage of this program.
      --help-opt=OPTION    Give help information for a given option
   -v --verbose[=VERBOSITY] Give information about what the program is doing.
                            Set value to control what information is given.
   -l --url-list=FILENAME  File with complete list of URLs to schedule
   -s --schedule=FILENAME  Override location of the schedule
   -t --spread-time=SECONDS Time over which to spread checking; default 10 days

      --config-file=FILENAME Load in an additional configuration file

DESCRIPTION

This program takes a links database and builds an entire schedule from scratch for them. This can then be later used by daily-check-links to check all of the links.

By default build-schedule builds a schedule for all of the links in your links database but you can give it a list of URLs in a file in which case the schedule built will only contain those links.

The schedule tries to spread link checking into the future with more links being checked soon and fewer later. As links are scheduled for repeat checking this should work out to a reasonably even rate of checking.

If there is an already a schedule file in existance, it will be read and the times in the old database will be reused. The old database will be renamed with a .bak extension.

EXAMPLES

   build-schedule

If everything is set up correctly and you don't have any special needs then you don't have to give any arguments.

   build-schedule --ignore-links --spread-time=7200

Causes an immediate pulse of activity which tests all of the links in the database within the next two hours. Needless to say, this will cause considerable amounts of network traffic and is a bad idea in most normal situations.

BUGS

The program doesn't check the validity of its output database, so if the output filesystem fills up things can go horrible. Check afterwards.

SEE ALSO

verify-link-control(1); extract-links(1); build-schedule link-report(1); fix-link(1); link-report.cgi(1); fix-link.cgi suggest(1); link-report.cgi(1); configure-link-control

The LinkController manual in the distribution in HTML, info, or postscript formats, included in the distribution.

http://scotclimb.org.uk/software/linkcont/ - the LinkController homepage.