/ 
distlinks-2
River stage zero No dependents
/ distlinks

NAME

distlinks -- check URL links, with database cache

SYNOPSIS

distlinks [--options] filename-or-dirname...

DESCRIPTION

Distlinks checks URLs found in files or a directory tree of files. An SQLite database avoids rechecking links between multiple program runs. It's a bit rough yet but is good for checking everything in a software distribution or similar.

Various file types are recognised and read appropriately to extract text parts.

  • .gz and .bz2 gzip or bzip2.

  • .tar and .tar.gz Unix tar.

  • .zip

  • Text with UTF-16 or UTF-32 BOM.

  • Image files per Image::ExifTool, so the text parts of PNG, JPEG, etc.

  • .mo message catalogue.

  • Executables ELF, MS-DOS, etc per File::Type (such files skipped).

URLs are distilled from text with free-form matching so they can be in plain text, program code, etc. The following specific forms are recognised,

  • Angles <http://foo.com> and <URL:http://foo.com> as sometimes recommended for mail messages etc.

  • Quotes `http://foo.com' per Emacs docstrings.

  • Bare foo.com/index.html taken to be http:.

  • Texinfo @url{http://foo.com}.

  • HTML href="foo.html", interpreted relative to a <base> or the file itself.

  • Variables $FOO in the URL taken to be program code etc and not checked.

COMMAND-LINE OPTIONS

The command line options are

-V
--verbose
--verbose=N

Print some diagnostics about what's being done. With --verbose=2 or --verbose=3 print some technical details too. Eg.

distlinks --verbose
--version

Print the distlinks program version number. With --verbose=2 also print version numbers of some modules used.

CHECKING

news

Newsgroup references like "news:some.group.name" are checked by asking the news server whether the group exists. The default server ends is per Net::NNTP, which means an NNTPSERVER or NEWSHOST environment variable, or a Net::Config setup. For convenience distlinks tries "localhost" if none of those are set.

ENVIRONMENT VARIABLES

NNTPSERVER
NEWSHOST

News server host name or IP number.

FILES

~/.distlinks.sqdb

SQLite database of information kept about checked URLs.

/etc/libnet.cfg
/etc/perl/Net/libnet.cfg

Net::Config configuration, for news server.

SEE ALSO

Net::Config

chklinks

HOME PAGE

http://user42.tuxfamily.org/distlinks/index.html

LICENSE

Copyright 2009, 2010 Kevin Ryde

Distlinks is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Distlinks is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Distlinks. If not, see http://www.gnu.org/licenses/.