XMLTV::Supplement (3) - Linux Man Pages
XMLTV::Supplement: Supplementary file loader for XMLTV grabbers
XMLTV::Supplement - Supplementary file loader for XMLTV grabbers
DESCRIPTIONUtility library that loads supplementary files for xmltv-grabbers and other programs in the xmltv-distribution.
Supplementary files can be loaded either via http or from a local file, depending on the configuration of the module. The default is to load the files from http://supplement.xmltv.org. This can be changed by setting the environment variable XMLTV_SUPPLEMENT to the new root-directory or root-url for supplementary files.
EXPORTED FUNCTIONSAll these functions are exported on demand.
Load a supplement file and return it as a string. Takes two parameters:
directory and filename.
my $content = GetSupplement( 'tv_grab_uk_rt', 'channel_ids' );
GetSupplement will always return a string with the content. If it fails to get the content, it prints an error-message and aborts the program.
Load a supplement file and return it as an array. Any comments or blank lines
will be removed. Takes two parameters: directory and filename.
my $content = GetSupplementLines( 'tv_grab_uk_rt', 'channel_ids' );
GetSupplementLines will always return an array with the content. If it fails to get the content, it prints an error-message and aborts the program.
- Get the supplement file from the local machine
- Get the supplement file from a URL
Get the base directory containing supplementary files.
- Set the root directory for loading supplementary files.
SetSupplementRoot( '/usr/share/xmltv' ); SetSupplementRoot( 'http://my.server.org/xmltv' );
- Get the root directory for loading supplementary files.
CACHINGThe module stores all downloaded files in a cache. The cache is stored on disk in ~/.xmltv/supplement on Unix and in CSIDL_LOCAL_APPDATA//xmltv/supplement on Windows.
If a file has been downloaded less than 1 hour ago, the file from the cache is used without contacting the server. Otherwise, if the file has been downloaded more than 1 hour ago, then the module checks with the server to see if an updated file is available and downloads it if necessary.
ENVIRONMENT VARIABLESThe XMLTV_SUPPLEMENT environment variable can be used to tell the module where the supplementary files are found.
The XMLTV_SUPPLEMENT_VERBOSE environment variable can be used to get more debug output from XMLTV::Supplement.
COPYRIGHTCopyright (C) 2007 Mattias Holmlund.
This program 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 2 of the License, or (at your option) any later version.
This program 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 this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.