$Id: README,v 1.12 2003/11/02 15:36:40 ldv Exp $

1. Installation

  In order to prepare package hasher to use by <user>, you must add pair
  of special satellite users.  Run as root
  # hasher-useradd <user>

2. Usage

  The package hasher consists of several low-level utilities placed in
  /usr/share/hasher/, and high-level utility, /usr/bin/hsh.

  Example of use:
  $ hsh workdir path/to/foobar-1.0.src.rpm

  Working directory ("workdir" in example above) MUST exist.

  Working directory shouldn't contain self-made files or directories
  with names "aptbox", "cache", "chroot", "lockdir" and "repo".

  During the work hasher creates auto repository, workdir/repo.
  Result of successful build will be placed into this repository.

  Useful options:
    --no-stuff
    Do not use packages from auto repository in build system.
    By default, auto repository will be used as well as system repository.

    --nprocs=NUMBER
    Number of CPUs to use.
    By default, number of CPUs is calculated using /proc/stat data.

    -v, --verbose
    Print a message for each action.  Useful for tracing and/or
    getting detailed progress information.

  See "hsh --help" for detailed information about valid options.

3. Requirements.

  Filesystem where workdir is located should not be mounted with
  "noexec" or "nodev" options.

  Package repository used for creating build system must provide
  following packages:
  fakeroot >= 0:0.7.3
    (required for proper TCB support);
  rpm-build >= 0:4.0.4-alt21
    (required for proper package contents indices support);
  kernel-headers-common >= 1.1.4-alt1
    (required for "adjust_kernel_headers --first" support).

  Only local source methods (i.e. file and copy) are supported.

4. Bug reporting.

  In case of usage problems, write to
  "ALT Devel discussion list" <devel@altlinux.ru>

  In case of bug reports, visit BTS
  http://bugs.altlinux.ru/

