STOREID...REWRITE(8)

📦
version 7.7 · 27 versions
, in arch rolling

🌸 STOREID_FILE_REWRITE(8) — like, the file-based Store-ID helper for Squid, bestie 🌸

okay so real quick — this is a User Contributed Perl Documentation page, section 8 of the manual. The whole thing is about storeid_file_rewrite, and honestly? she's iconic. let's get into it 💅

✨ NAME ✨

storeid_file_rewrite — the File based Store-ID helper for Squid. yes that's her whole job. no cap. 🎀

✨ SYNOPSIS ✨

storeid_file_rewrite filepath

that's it. that's the whole vibe. one argument. slay. 🦋

✨ DESCRIPTION ✨

okay so bestie, picture this: this program acts as a store_id helper program, and what it does is rewrite URLs passed by Squid into storage-ids. why do we care? because that's how you get better caching for websites that use a bunch of different URLs for literally the same content. main character energy: the URLs are different but the content is one. 🔥

it takes a text file with two tab separated columns, and here's the tea:

  • Column 1: Regular expression to match against the URL
  • Column 2: Rewrite rule to generate a Store-ID

Eg:

^http:\/\/[^\.]+\.dl\.sourceforge\.net\/(.*)  http://dl.sourceforge.net.squid.internal/$1

Rewrite rules are matched in the same order as they appear in the rules file. so, for best performance, sort it in order of frequency of occurrence. lowkey the order matters, highkey the speed matters. ⭐

This program will automatically detect the existence of a concurrency channel-ID and adjust appropriately. and it may be used with any value 0 or above for the store_id_children concurrency= parameter. flexible queen. 👑

✨ OPTIONS ✨

girl there's exactly one (1) command line parameter, and it is:

  • the regex rules file name — that's the whole list. no secret flags. nothing hiding. periodt. 💀

✨ AUTHOR ✨

This program and documentation was written by Alan Mizrahi <alan@mizrahi.com.ve> 🫶

Based on prior work by Eliezer Croitoru <eliezer@ngtech.co.il>

real talk, the legal bits matter, so here they are in full, verbatim, no edits:
 * Copyright (C) 1996-2026 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 <alan@mizrahi.com.ve>
 Based on code from Eliezer Croitoru <eliezer@ngtech.co.il>
 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.

✨ QUESTIONS ✨

Questions on the usage of this program can be sent to the Squid Users mailing list <squid-users@lists.squid-cache.org> — they're lovely, go say hi 💌

✨ REPORTING BUGS ✨

  • Bug reports need to be made in English. fr fr, that's the rule. see https://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. 📝
  • Report bugs or bug fixes using https://bugs.squid-cache.org/ 🐛
  • Report serious security bugs to Squid Bugs <squid-bugs@lists.squid-cache.org> 🔒
  • Report ideas for new improvements to the Squid Developers mailing list <squid-dev@lists.squid-cache.org> 💡

✨ SEE ALSO ✨

okay that's the whole page bestie, you ate that reading it 💖 this cutie was brought to you by perl v5.42.2 and dated 2026-08-25 — go forth and cache responsibly 🧚‍♀️🌈👑

📦 where this page comes from