Sorcery Commands
The sorcery command is a menu-driven interface for all sorcery scripts. Command line options: -u|update
- Updates the sorcery scripts only. This option is non-interactive and does not start up the menu-driven interface. It is suitable for use in cron jobs.
-s|system-update
- Perform a system update (updates sorcery, grimoire, and spells). [ sorcery update, scribe update, sorcery queue, cast --queue ]
-g|upgrade
- Update spells without first updating the grimoire. [ sorcery queue, cast --queue ]
-q|queue
- Compare installed grimoire to installed spells, generate queue of spells needing to be updated.
queue-security
- Queue spells that had updates due to security fixes.
-r|rebuild
- Automatically rebuilds all installed software packages. This option is non-interactive except for a bunch of config and depends questions the first time you run it.
-rr|rebuild-reconfigure
- Automatically rebuilds all installed software packages. Unlike -r, this option makes cast reask all the questions unconditionally.
hold <spell|s>
sets <spell|s> to held. This means that they stay installed, but that cast will refuse to cast them. This will prevent them from being updated or changed at all. This might be helpful if you change kernel versions and the package won't build right on the new system, but still install (wrong).
unhold <spell|s>
unholds <spell|s>, changes their status from held back to installed.
exile <spell|s>
sets <spell|s> to exiled. This means that they won't be installed in any way, sorcery just ignores them.
unexile <spell|s>
removes exiled status from <spell|s>. This means that they can be installed again.
add-queue <spell|s>
- Add spell(s) to install queue
remove-queue <spell|s>
- Remove spell(s) from install queue
The menu system of sorcery allows managing grimoires, spells, and changing features of a system easily.
Sorcery Menu
Spell Menu - Selecting this will allow you to add spells, rebuild the system, hold spells, remove spells, select spells to install/remove, and updates your spells.
Options Menu - Allows you to customize your sorcery options.
Sorcery Branch - Allows you to select which branch of sorcery you wish to track. The two branches of sorcery you can use are the Devel branch and the Stable branch. NOTE: don't get this confused with the codex, the branches are for the sorcery scripts themselves only, not the grimoire.
Prompt Delay - Changing this allows you to shorten or elongate the amount of time the sorcery scripts wait at a prompt before it automatically chooses the default.
Download Rate - This lets you put a limit, if you so choose, on how many bytes per second summon downloads files. If you don't wish there to be any limit just leave this blank.
Email of Sorcerer - This allows you to enter in the email address you wish to recieve reports about the box.
Feature Menu - Allows you to select/deselect various sorcery features.
Integrity Checking - Allows you to change options for checking the integrity for system integrity checking and download integrity checking.
Number of "make" Jobs - This allows you to specify the maximum number of jobs make should run at a time. Setting this to 0 will mean there is no limit. WARNING: Setting this to more then 1 is risky as not all makefiles support concurrent builds.
Distributed Compiling which allows you to setup distributed compiling by specifying which volunteer computers will be helping with the compiling process, or you can leave it blank to disable distributed compiling all together.
Software Mirrors - Allows you to select which mirrors you wish to use to download spells in a certain category.
Optimize Architecture - This allows you to choose how you wish to optimize the spells you compile later.
Sorcery Development - Allows you to debug sorcery. This is mainly for developers and thus the debug file should be kept at /dev/null unless you really wish to use this option.
Log Menu - Allows you to set some specific log files
Grep Install Logs - Lets you search through install logs.
View Install Log - Shows you the install log of a spell.
Edit Install Log - Opens up the install log under your specified editor for editing.
View Compile Log - Shows you the compile log of a spell.
Remove Compile Log - Allows you to remove a compile log of a spell from the system.
Queue Menu - Manage sorcery queues
View Install Queue - Shows the list of spells that have been selected for installation
Edit Install Queue - Opens your editor for you to change the list of spells which are tagged for install.
View Removal Queue - Shows the list of spells that have been selected for removal.
Edit Removal Queue - Opens your editor for you to change the list of spells which are tagged for removal.
View Spell Status - Shows the datafile of installed spells.
Edit Spell Status - Opens your editor for you to edit the datafile of installed spells.
Foreground Execute - Exits the sorcery command to process all the queues.
Background Execute - Processes the queues. It will then return you to the sorcery menu and continue to process the queues in the background.
Cabal Menu - Allows you to administrate groups of Unix/Linux boxes.