About News Download Docs Bugs Contact

Sorcery/Commands/Delve

Information

Tools

Resources

Delve command

delve is a low-level tool that allows the running of single spell states such as PRE_BUILD and INSTALL. It should not be used normally as it can harm one's system if used improperly. As such, please do not complain if your system becomes broken if this is used. Consider if what your doing could be useful to more than one person. If it can, file a bug report to get the spell changed.

Usage of delve comes in these forms:

# delve [-f] -c <beginning> <end> <spell>
# delve [-f] <spell> <state0> [ <state1> ... <stateN> ]
# delve <spell> success|failure

Please note that -fc does not imply -f and -c and -f must be the first flag.

delve, although against recommendation, can be useful to circumvent dependencies, such as when there are files that would fulfill a spell's dependencies otherwise or to fix up a spell's source interactively in order to use make strength to recompile only what is needed. It can also be useful for debugging.

Spell states depend on build API. The spell states for each API are listed, as well as the order of the states. The default is API 2.

API1=start PRE_BUILD config_loc BUILD POST_BUILD POST_INSTALL TRIGGERS end
API2=start PRE_BUILD config_loc BUILD PRE_INSTALL INSTALL INSTALL_EXTRAS POST_INSTALL TRANSFER FINAL TRIGGERS end