ftn-srif - A Perl script to process file requests via an incoming SRIF file
Version 0.09
ftn-srif srif_path_and_file
ftn-srif is a an external request processor that is passed the name and path of an SRIF (Standard Request Information File) on its command line. It expects to find a configuration file named ftn-srif.cfg one directory up from the directory that the SRIF is located in, and from that determines the location of its Log file and the 'Magic' file it will will be using during processing.
It then uses the parse_srif function from the FTN::SRIF module to get the contents of the SRIF, especially the following:
This is the path and filename of the list containing the requested files.
This is the path and filename of the response list. It must not be equal to RequestList. One file per line, including the full path to the file. The first character defines the way the mailer should act after sending that file:
= erase file if sent successfully + do not erase the file after sent - erase the file in any case after session
It then processes the filenames list in the RequestList file. If the system has the file being requested, the name and path for it is added to the ResponseList file for the mailer to send back to the requesting system and a note regarding that is added to a response message that will also be sent to the requesting system. If it does not, a note about not having that file is added to the result summary message.
This is the contents of an example ftn-srif.cfg file:
[SRIF] LogFile=/opt/ftn/log/srif.log MagicFile=/opt/ftn/magic.txt DefaultFile=/opt/ftn/freqerr.txt
This is an example line in a BinkD configuration file to make use of ftn-srif:
# Run an external program. # The "*S" macro in command line substed with S.R.I.F., see !SRIF.TXT # exec "/opt/ftn/bin/ftn-srif *S" *.req
An example of a command line that ftn-srif might see:
C<ftn-srif /opt/ftn/pin/07800220.srf>
Robert James Clay, <jame at rocasa.us>
<jame at rocasa.us>
Please report any bugs or feature requests to bug-ftn-srif at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=FTN-SRIF. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-ftn-srif at rt.cpan.org
You can find documentation for this with the perldoc command.
perldoc ftn-srif
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=FTN-SRIF
L<FTN::SRIF>
Copyright 2001-2003,2010-2012 Robert James Clay, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install FTN::SRIF, copy and paste the appropriate command in to your terminal.
cpanm
cpanm FTN::SRIF
CPAN shell
perl -MCPAN -e shell install FTN::SRIF
For more information on module installation, please visit the detailed CPAN module installation guide.