OSMOHLR(1)

📦
version 1.9.0 · 2 versions
, in ubuntu resolute, ubuntu stonking

💖 OsmoHLR — osmo-hlr 💖

okay bestie, welcome to OSMOHLR(1), a User Commands era classic ✨ this is the manual for OsmoHLR aka osmo-hlr and we're gonna get you fully caught up, no cap 🫶

🌸 SYNOPSIS 🌸

osmo-hlr

that's it. that's the whole synopsis. she's simple, she's elegant, she's giving main character energy 👑

🦋 DESCRIPTION 🦋

okay so. OsmoHLR, aka the Osmocom HLR, is a minimal implementation of the Home Location Register — which is literally just the subscriber database of a 2G/3G cellular network. she's the group chat admin of subscriber info, fr fr.

what does she hold onto? immaculate vibes and also:

  • the IMSI of every subscriber
  • the MSISDN of every subscriber
  • the secret key material — that's Ki, K/OP/OPc — so she can generate authentication vectors

bestie, key point, and I mean literally: OsmoHLR does NOT support the classic TCAP/MAP protocol 🙅‍♀️ instead she implements the more light-weight, more slay, more her protocol: GSUP. iconic behavior honestly.

more lore lives here: https://osmocom.org/projects/osmo-hlr/wiki/OsmoHLR

✨ OPTIONS ✨

  • -h, --help — prints this text. the "help me bestie" flag 💅
  • -c, --config-file filename — the config file you wanna use.
  • -l, --database db-name — the database you wanna use.
  • -d option, --debug=DRLL:DCC:DMM:DRR:DRSL:DNM — turn on debugging. yes the format is that whole colon chain, respect the colon chain 🌈
  • -D, --daemonize — fork the process into a background daemon. she's going off to do her own thing 🦋
  • -s, --disable-color — do not print ANSI colors in the log. (sad, I know, but sometimes you gotta be monochrome 💀)
  • -T, --timestamp — prefix every log line with a timestamp. chronological queen ⏰
  • -e, --log-level number — set a global loglevel.
  • -U, --db-upgrade — allow HLR database schema upgrades. glow-up permission granted ✨
  • -C, --db-check — quit after opening (and upgrading) the database. in and out, no loitering 🚪
  • -V, --version — print the version of OsmoHLR.

🎀 VTY reference generation: 🎀

  • --vty-ref-mode MODE — VTY reference generation mode (e.g. 'expert').
  • --vty-ref-xml — generate the VTY reference XML output and exit.

Copyright © 2016-2023 by Harald Welte, sysmocom s.f.m.c. GmbH License AGPLv3+: GNU AGPL version 3 or later http://gnu.org/licenses/agpl-3.0.html

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. bestie I'm serious, zero warranty, none, nada 😭 read it and weep (but legally)

💜 SEE ALSO 💜

The full documentation for OsmoHLR is maintained as a Texinfo manual. If the info and OsmoHLR programs are properly installed at your site, the command

info OsmoHLR

should give you access to the complete manual. go get that lore 📚✨

and that's the whole page bestie!! 🫶 this was OsmoHLR version 1.9.0, dated January 2026, filed under OSMOHLR(1) in the User Commands section. slay, periodt, go manage those subscribers 💅🌸🔥

📦 where this page comes from