ERROR(2)                                                 ERROR(2)

     NAME
          Error, stderr, error, panic, kill, checkload - Error
          handling and diagnostics

     SYNOPSIS
          include "error.m";
          err := load Error Error->PATH;

          init:     fn(s: Sys);
          kill:     fn (pid: int, msg: string): int;
          error: fn(e: string);
          panic: fn(e: string);
          checkload: fn[T](x: T, p: string): T;

          stderr: ref Sys->FD;

     DESCRIPTION
          Error provides functions used to deal with errors that are
          popular. Before any other thing, init must be called to ini-
          tialize the module.

          Kill writes the msg given to the control file for the pro-
          cess identified by pid. It returns -1 upon errors.

          The functions error and panic are similar. They print the
          given diagnostic to standard error and raise an expection.
          The second one will make the process break, for debugging.

          Checkload is intented to load a module and return it, check-
          ing out that the module did indeed load. In case of error it
          calls error with an appropriate message, using the second
          argument as the name of the file that could not be loaded.

          The global stderr is standard error, for use from other mod-
          ules as well.  Beware that using pctl(2) may leave stderr
          closed, despite being not null.

     SOURCE
          /usr/octopus/port/lib/error.b