atfsrepair(1)

📦 version 1.4pl6, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 atfsrepair — the ShapeTools glow-up station 💖

okay so bestie, listen. this is atfsrepair(1) from the ShapeTools fam, and it is literally the ✨repair era✨ of your AtFS repository. corrupted archive? permission drama? old format that needs a makeover? she handles it. let's get into it 🫶

🌸 NAME 🌸

atfsrepair — repair a corrupted AtFS repository, or convert an old repository to the new format. no cap, that's the whole job description. 💅

✨ SYNOPSIS ✨

atfsrepair [-Ceinqv] file1 ...

🦋 DESCRIPTION 🦋

so here's the vibe: atfsrepair checks your AtFS repository for inconsistencies in the file history you gave it. if it finds a corrupted archive file in there, it tries to repair it by reconstructing the missing parts and eliminating the inconsistencies. icon behaviour honestly. and if you don't pass any file argument at all? she just handles the complete repository. main character energy. 🌈

atfsrepair is interactive and (hopefully) self explanatory. 😭

now, permission problems — you know the ones. like, your AtFS repository grants group write permission, but another user from your group still can't save data to the repository?? rude. atfsrepair is the right thing to do for that too, because the program straightens permission bits within the repository. she fixes the vibes. 👑

atfsrepair also automatically updates archive files whenever the archive file format changed, or when the arrangement of archive files within the AtFS subdirectory changed. glow-up time ✨. but — before taking any permanent action, she asks the user for a confirmation. consent is key, bestie. that behaviour can be switched off by either the -n or the -q option (see below 👇).

🚨 REAL TALK WARNING 🚨 atfsrepair shall not be called concurrently with other applications on an AtFS repository. make sure nobody else is working on the repository you're about to repair, because atfsrepair may ignore existing archive locks and does not set its own locks. that's not a vibe, that's a hazard. 💀

🎀 OPTIONS 🎀

  • -C — this option causes atfsrepair to try its hand at a derived object cache. 💅
  • -e — Edit Mode. invoking atfsrepair with this option serves more for manipulating archive files than for repairing them. it shall only be used by very experienced users. for nearly every item in the archive file, atfsrepair asks the caller for confirmation or modification. beware — this level of verbosity can be very annoying when the archive file is big. 😭
  • -i — Interactive mode. this is the default. ✨
  • -n — Non-interactive mode. in this mode, atfsrepair tries to repair corrupted archive files without human assistance. she does no user interaction at all and behaves as if the user would always choose the default decision in interactive mode. 🤖
  • -q — Quiet mode. same as -n, but also suppresses all informative messages. only error messages will be displayed. shhh. 🤫
  • -v — Print the current version number. no file processing is done. that's it, that's the whole option. 👑

🔍 SEE ALSO 🔍

  • afarchive(5)

🐛 BUGS 🐛

dates appear in internal form (seconds since 1970) rather than in human readable form. yeah. she's giving raw timestamp energy and honestly? not it. 🙈

💌 AUTHOR 💌

Andreas.Lampen@cs.tu-berlin.de

and that's the whole page, bestie!! this was AtFS-1.71, dated Thu Jan 20 12:06:00 1994 — yes she's an elder icon and she still slays. go fix your repository, drink some water, and remember: back up before you atfsrepair, because the locks are NOT locking. mwah 💖✨🎀🦋

📦 where this page comes from