LEIL-TOPOLOGY.CFG(5)

📦 version 5.12.0, in nixpkgs unstable

💅 leil-topology.cfg — like, the whole manual, bestie

okay so this page is LEIL-TOPOLOGY.CFG(5) — the fifth section, the config-file girlies. it's your map of who lives where on the network 🗺️✨

🌸 NAME 🌸

leil-topology.cfg — the network topology definitions for LeilFS 🫶

✨ DESCRIPTION ✨

so leil-topology.cfg is the file where you assign IP addresses to network locations — and those locations are usually switch numbers, iykyk. 🔥

it's optional, bestie. totally up to you. if your network is just one switch, or you genuinely don't care about decreasing traffic between switches (no shame, live your truth), then just leave this file empty 💀

🎀 SYNTAX 🎀

the syntax is literally this, no cap:

ADDRESS SWITCH-NUMBER

lines starting with a # character are ignored (comments, periodt 💅).

ADDRESS can be specified in several forms, and here's all of them:

  • * — all addresses, every single one 👑
  • n.n.n.n — a single IP address
  • n.n.n.n/b — IP class specified by network address and bits number
  • n.n.n.n/m.m.m.m — IP class specified by network address and mask
  • f.f.f.f-t.t.t.t — IP range specified by from-to addresses (inclusive)

and SWITCH-NUMBER? can be specified as any positive 32-bit number. any. positive. 32-bit. number. 🧚

💖 NOTES 💖

okay important stuff, listen up 🙈

if one IP belongs to more than one definition, then the last definition is used. last one wins, iconic behaviour.

as for now, distance between switches is constant. so distance between machines is calculated like this:

  • 0 when IP numbers are the same
  • 1 when IP numbers are different, but switch numbers are the same
  • 2 when switch numbers are different

distances are used only to sort chunkservers during read and write operations. new chunks are still created randomly — no favourites, they're all just vibing. and also, rebalance routines do not take distances into account. so like, don't @ them about it. 🦋

🍓 REPORTING BUGS 🍓

found a bug? report it to the GitHub repository at https://github.com/leil-io/leilfs as an issue. please and thank you 🫶

Copyright 2008-2009 Gemius SA

Copyright 2013-2019 Skytechnology sp. z o.o.

Copyright 2023-2024 Leil Storage OÜ

LeilFS 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, version 3.

LeilFS 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 LeilFS. If not, see http://www.gnu.org/licenses/.

fr fr, read the license, it's the whole vibe check for what you're allowed to do 💜

🌈 SEE ALSO 🌈

and that's the whole page, bestie 🎀 it's from the LEIL-TOPOLOGY.CFG(5) source and totally dated 1980-01-01 which is a whole mood honestly 😭💀 go configure something iconic ✨👑

📦 where this page comes from