------------------------------------------------------------ revno: 13683 revision-id: squid3@treenet.co.nz-20141208083751-za559fem6v9igupl parent: squid3@treenet.co.nz-20141208083602-5oqoelcrcdyd6hw7 committer: Amos Jeffries branch nick: 3.5 timestamp: Mon 2014-12-08 00:37:51 -0800 message: storeid_file_rewrite: update man(8) documentation ------------------------------------------------------------ # Bazaar merge directive format 2 (Bazaar 0.90) # revision_id: squid3@treenet.co.nz-20141208083751-za559fem6v9igupl # target_branch: http://bzr.squid-cache.org/bzr/squid3/3.5 # testament_sha1: db419a81566cb9932b6bd5107f40ba168fe0c9db # timestamp: 2014-12-08 08:52:28 +0000 # source_branch: http://bzr.squid-cache.org/bzr/squid3/3.5 # base_revision_id: squid3@treenet.co.nz-20141208083602-\ # 5oqoelcrcdyd6hw7 # # Begin patch === modified file 'helpers/storeid_rewrite/file/storeid_file_rewrite.pl.in' --- helpers/storeid_rewrite/file/storeid_file_rewrite.pl.in 2014-09-13 13:31:49 +0000 +++ helpers/storeid_rewrite/file/storeid_file_rewrite.pl.in 2014-12-08 08:37:51 +0000 @@ -1,17 +1,18 @@ #!@PERL@ + use strict; use warnings; -$|=1; +use Pod::Usage; =pod =head1 NAME -storeid_file_rewrite - File based Store-ID helper for Squid + storeid_file_rewrite - File based Store-ID helper for Squid =head1 SYNOPSIS -storeid_file_rewrite filepath + storeid_file_rewrite filepath =head1 DESCRIPTION @@ -31,7 +32,63 @@ This program will automatically detect the existence of a concurrecy channel-ID and adjust appropriately. It may be used with any value 0 or above for the store_id_children concurrency= parameter. -For more information please see http://wiki.squid-cache.org/Features/StoreID +=head1 OPTIONS + +The only command line parameter this helper takes is the regex rules file name. + +=head1 AUTHOR + +This program and documentation was written by I> + +Based on prior work by I> + +=head1 COPYRIGHT + + * Copyright (C) 1996-2014 The Squid Software Foundation and contributors + * + * Squid software is distributed under GPLv2+ license and includes + * contributions from numerous individuals and organizations. + * Please see the COPYING and CONTRIBUTORS files for details. + + Copyright (C) 2013 Alan Mizrahi + Based on code from Eliezer Croitoru + + 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. + +=head1 QUESTIONS + +Questions on the usage of this program can be sent to the I> + +=head1 REPORTING BUGS + +Bug reports need to be made in English. +See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. + +Report bugs or bug fixes using http://bugs.squid-cache.org/ + +Report serious security bugs to I> + +Report ideas for new improvements to the I> + +=head1 SEE ALSO + +squid (8), GPL (7), + +The Squid wiki http://wiki.squid-cache.org/Features/StoreID + +The Squid Configuration Manual http://www.squid-cache.org/Doc/config/ =cut @@ -52,6 +109,7 @@ } close RULES; +$|=1; # read urls from squid and do the replacement URL: while () { chomp; @@ -75,32 +133,3 @@ } print $channel, "ERR\n"; } - -=pod - -=head1 COPYRIGHT - - * Copyright (C) 1996-2014 The Squid Software Foundation and contributors - * - * Squid software is distributed under GPLv2+ license and includes - * contributions from numerous individuals and organizations. - * Please see the COPYING and CONTRIBUTORS files for details. - -Copyright (C) 2013 Alan Mizrahi -Based on code from Eliezer Croitoru - -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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. - -=cut