session-migration(1)

📦 version 0.3.9build2, in ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

session-migration 💖

okay bestie, this is session-migration from the Linux User's Manual — it's a lil autostart helper that moves your user session data around when stuff changes. she's lowkey the backstage crew of your session and you never notice her until you need her. periodt. ✨

🌸 NAME 🌸

session-migration — migrate in user session settings 💅

✨ SYNOPSIS ✨

session-migration [options]

🦋 DESCRIPTION 🦋

so the tea is: session-migration is the program you use to migrate in-session user data — like when a program is evolving its configuration, or when it just needs some files moved and so on. 🎀 This program is generally autostarted at the very beginning of the session and it integrates caching capabilities. she's up before you are, fr fr.

the general usage? ship an executable file in XDG_DATA_DIR/session-migration/scripts. that one gets executed the next time the user logs into the session. and not just that one — it runs all executable files there in ascii order, one after another. 💫

and even though the program tries to cache some timestamp and scripts so they don't get launched twice (they are skipped on subsequent runs), the executables file should be idempotent. no cap. 🫶

not me stressing this but like — make them idempotent anyway, bestie, it's the vibe check for good migration scripts. 😭

💜 OPTIONS 💜

  • --dry-run — this parameter lets you run the session-migration tool without really launching the scripts and without marking them as migrated. it's generally used with --verbose for debugging purposes. it's giving "rehearsal, not the show" 🎭
  • --file filename — this parameter, followed by a path or filename, tells session-migration to only consider that script file and ignore XDG_DATA_DIR. it also won't log this special file as being migrated. very "just this one, thanks" energy 🙈
  • --help — display a quick command help. she's helpful AND humble, iconic 👑
  • --verbose — show a lot of verbose information. it can be used by the user to debug configuration issues. turn it on when you're sleuthing 🕵️♀️

that's the whole page, bestie — every flag, every path, every vibe, preserved. 🌈

sign-off time: this one is dated 12 July 2012 and she's page session-migration(1) of the manual. old but gold, fr fr. 💖✨🎀🦋🌸

📦 where this page comes from