Seth Woolley's Man Viewer

alter(8) - alter, alter - changes spells after they have been installed - man 8 alter

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

ALTER(8)                     System Administration                    ALTER(8)



NAME
       alter - changes spells after they have been installed

SYNOPSIS
       alter [action] [parameters]

DESCRIPTION
       alter  is  part of the sorcery source-code package management suite. It
       is a command-line tool to change spells after they have been installed.

       Basically,  what  this  does  is change a spell's logs so sorcery has a
       better idea of what files are supposed to be.  This ought to help  fix-
       ing  the  problems  we've been having running cleanse --fix with md5sum
       checking turned on.

OPTIONS
       -a, --alter
              This is the default action of alter.  It will run a command  and
              add  all  the  files  it  touched to the spells' install log and
              change the cache and md5sum log.

              parameters:

              -n|--spell <spell>

              specify which spell to alter.  If not  given,  the  pseudo-spell
              "alter" is altered.  If the spell does not exist yet, it is cre-
              ated.

              -v|--version <version(1,3,5)>

              specify which version(1,3,5) of the logs to alter.  Note: it seems like
              -v is getting overridden in(1,8) the source !?

              <command>

              The  main part. This is the command to run. This command will be
              tracked like a command during spell install. Note that this com-
              mand  will be run as "$@"|bash, which means that you may have to
              double-escape some things (or put the whole command in(1,8) '')

       -m, --md5mend <spell(s)>
              This is another major action of alter.  It will scan the install
              logs  of  all  the spells on the command line for files that are
              also in(1,8) the install log of other, "environmental" spells.  those
              files  will  be  removed  from  all environmental spells' md5sum
              logs.  This should fix the problem that cleanse --fix is  overly
              touchy with md5sum checks turned on.

       -p, --prelink [prelink args]
              This  will prelink all binaries on your system. This makes espe-
              cially C++ apps with many links a lot faster  (KDE).  All  files
              touched  will be added to the pseudo-spell "smgl-prelink". alter
              -m smgl-prelink is run automatically.  DO NOT dispel that spell.
              It  is not in(1,8) the sustained spells for some reason, but doing so
              will wipe all executables off your system...

              If no prelink args are given, the defaults are "-afmR".

       -z, --strip-all [strip args]
              This will strip debugging symbols from all binaries on your sys-
              tem.   This  will  make  the  binaries smaller. If you want both
              strip and prelink, strip before  prelink  is  recommended.   The
              pseudo-spell created here is smgl-strip.  The default options to
              strip are "".

       note:  the first time(1,2,n) you run one of these last two commands, They will
              create  /etc/prelink.conf,  a listing of all directories on your
              system that contain binaries. This takes a long time.

       -s, --strip '<spell[s]>' [strip args]
              This lets you strip specified spells.  Several spells have to be
              given as

              alter -s "spell1 spell2" [strip args]

              If one spell is given, the spell logs of that spell are altered.
              If multiple spells are given, smgl-strip is altered.

       -h --help --about
              Displays a longer help message.

NOTES
       Never dispel an alter (spell alter,  smgl-prelink,  smgl-strip)  unless
       you want to delete everything the alter touched!

       Instead,  use  the  undo archives (created after a md5mend): (This will
       restore the original md5sum logs. Nothing else!)

       dispel -d <spell>-undo <version(1,3,5)> alter -m <spell>-undo

       Note that all these archives take up a lot of space. To save a  drastic
       amount  of  space  in(1,8)  /var, set(7,n,1 builtins) ARCHIVE=off.  In alter, this will keep
       alter from creating compile caches for the spells it touches. This  may
       actually  make sense.  Otherwise, smgl-prelink and smgl-strip will have
       caches of 1-2gig each (your mileage may vary).

       For casts however it may be intelligent to turn ARCHIVE back on so  you
       have an easy rollback in(1,8) case something fails.

WARNING
       alter  is still under development and freshly written.  Do not use this
       on a production system, it may still be pretty buggy.

AUTHOR
       Manpage by Karsten Behrmann, source by Seth Woolley.

       Maintained    by     the     Source     Mage     GNU     Linux     Team
       (http://www.sourcemage.org)


REPORTING BUGS
       Report bugs to bugzilla <http://bugs.sourcemage.org>

SEE ALSO
       cast(8),  cleanse(8),  dispel(8),  gaze(1),  grimoire(5), scribbler(8),
       scribe(8), sorcery(8), sorcery_config(8), summon(8)

WARRANTY
       This is free software with ABSOLUTELY NO WARRANTY



Source Mage GNU Linux           September 2004                        ALTER(8)

References for this manual (incoming links)