GAZE(1)

NAME
gaze - query/view sorcery package management information

SYNOPSIS

gaze [-q] [-g <grimoires>] <what> [<arguments>]

DESCRIPTION
gaze is part of the sorcery source-based package management suite. It is a general purpose command-line tool for displaying package logs, version information, checking for installed packages, checksums, message digests, maintainer information, package URL information, removing obsolete packages, displaying new packages, untracked files, sections, searching for files that are installed, finding when spells were created and packages in the software catalogue. It can even take and retrieve snap shots of currently installed packages for easy duplication.

OPTIONS

  -q

    disable human style output.

  -g <grimoires>

    specify which grimoire(s) to look in. To pass more than one, encapsulate them in quotes.

  alien

    find and display all files which are not currently tracked by the sorcery package management system

  prune

    removes all old source code and old backups. otherwise the source code from previous versions is kept so that the packages can be rolled back to older versions. This does not delete sources that are up to date, but not installed. NOTE: This is deprecated. Use cleanse --sweep

  pam

    display spells installed that are pam aware

  orphans

    display installed spells that have no explicit dependencies on them

  activity

    show the activity log. (note: this is actually a log of all that happened involving sorcery, such as casts, summons etc.)

  install-queue

    shows the queue of spells waiting to be installed

  remove-queue

    shows the queue of spells waiting to be removed

  show-held

    shows all spells currently held (which means they are not to be updated)

  show-exiled

    shows all spells currently exiled (which means they are not to be cast in any way)

  provides <feature>

    displays spells that provide the feature

  what <spell>

    view the long package description

  short <spell>

    view the short package description

  where [-path] <spell>

    display the section a spell belongs to. If -path is given, display the full path to spell

  website|url <spell>

    display the URL for the specified spell

  sources <spell>

    list all source files contained in a spell

  source_urls <spell>

    lists the urls to all files contained in a spell

  maintainer <section>

    display the email address of the person currently responsible for maintaining a specified section

  compile <spell> [version]

    show the compiler output generated when the spell was built. If no optional version was given, try the installed version. If the spell is not installed use the version in the grimoire.

  install <spell>

    Used to determine what files were installed by a spell and where those files are located, excludes sorcery state files.

  install-full <spell>

    Like gaze install spell, but shows sorcery state files.

  install-spell <spell>

    Like gaze install spell, but excludes sorcery log files.

  version <spell>

    shows the installed version of the spell and the main grimoires version.

  versions <spell>

    shows the installed version of the spell and lists all available versions in all grimoires. If used without a spell name, then lists order of available grimoires.

  license <spell>|<section>|<license>

    view the license(s) of the given spell(s), or spells in given section(s), or view the information about given license(s)

  sum <spell>

    print CRC checksums for spells(s). If no spell is given it default to all.

  md5sum <spell>

    print spell MD5 message digests (fingerprints). If no spell is given it default to all

  size <spell>

    print the size of the installed spell(s).

  export

    take a snapshot of all spells currently installed to stdout.

  import <snapshot>

    restore the snapshot from a previous gaze export command (see the export option)

  grimoire <grimoire>

    prints specified grimoire's spells or all grimoires if grimoire-name is omitted

  grimoires

    displays installed grimoires by name only

  html [-s] <grimoire-name>

    prints the specified grimoire or all grimoires if grimoire-name is omitted in a nice html format. Additionally displays links to the source files when -s is given.

  search [-name|-short] phrase

    When omitting -name and -short searches spells name, short description and long description for phrase

    With -name searches spells name and with -short searches spells short description for phrase

    phrase can be any valid basic regular expression. Use quotes to protect it if needed.

  newer <date>

    print packages first submitted after a specified date. the date must be specified in the 'yyyymmdd' format, where y=year, m=month, and d=day. There are two special dates, last_sorcery_update and last_cast.

  older <date>

    print packages that were first submitted before a specified date. the date must be specified like for gaze newer. last_sorcery_update and last_cast may not be used here.

  from [<path>/]<file>

    find out what spell has installed path/file

  installed [<spell>]

    view all installed packages and corresponding version numbers or check to see whether a particular package is installed and if it is installed display its version number

  section <section>

    view a list of all sections in the software catalogue or display a list of packages from a specific section

  voyeur [<spell>|<delay>]

    start looking at what cast is compiling at the moment and outputs its compiler messages. A spell can be optionally specified, or a delay after which to abort when no casts could be found.

  SCRIPT_NAME <spell>

    replace SCRIPT_NAME with any of the following BUILD | CONFIGURE | CONFLICTS | DETAILS | DEPENDS | FINAL | HISTORY | INSTALL | PATCH | POST_BUILD | POST_INSTALL | POST_REMOVE | PRE_BUILD | PRE_INSTALL | PRE_REMOVE | PREPARE | PROVIDES | TRIGGERS to show that spell script for the spell

  history <spell>

    show history for a spell (alias for gaze HISTORY <spell> )

  checkmd5s [<spell>|<section>] [...]

    computes the md5sum on spell sources based on passed spell(s), section(s) or entire grimoire(s) if left blank.

  depends [--fast] <spell> [<level>]

    shows the spells that explicitly or recursively depend on this spell. Up to level $level if specified. If --fast is specified more limited output is produced, but it runs much faster.

  dependencies [-c ] [--no-optionals ] <spell> [<level>]

    shows the spells that spell explicitly or recursively depends on. Up to level $level if specified. The -c option skips trees that have already been shown, the --no-optionals flag skips optional dependencies.

AUTHOR
Original version written by Brian Peterson, modified by Kyle Sallee and updated by Thomas Stewart and Karsten Behrmann

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), grimoire(5), scribbler(8), scribe(8), sorcery(8), sorcery_config(5), summon(8)

WARRANTY
This is free software with ABSOLUTELY NO WARRANTY