Start Info Community Spielen
 
 

Morgengrauner Dokumentation

Dateipfad: /home/mud/mudlib/doc//driver/invocation

NAME
    driver/invocation

PURPOSE
    Description of the invocation of the gamedriver, especially of the command
    arguments. This document describes the commandline version of the driver
    only; non-commandline versions are platform specific and described in
    the related documentation.

DESCRIPTION
    The driver is invoked from the commandline as other normal programs.
    Neither the current directory nor the directory the executable is in need
    to be in any special relation the directory of the mudlib. Once the driver
    is running, it emits two streams of outputs:

      - driver-related messages on stderr; this unfortunately includes
        LPC compiler diagnostics
      - LPC runtime-related messages in the logfile /.parse.log
        (the name can be changed).

    It is possible to start the driver without any commandline arguments as
    suitable defaults are specified at compile time. The invocation syntax
    is:

        driver [options] []...

     the number of the port the driver shall use to accept
    connections. The maximum number of ports is determined by MAXNUMPORTS
    in the source file config.h.

    The options modify the behaviour of the gamedriver. Some of them are only
    available if a certain compile-time option was enabled (typically in
    the source file config.h). The following options are recognized:

      -P|--inherit 
        Inherit filedescriptor  from the parent process
        as socket to listen for connections.
        Only available if compiled with MAXNUMPORTS.

      -u|--udp 
        Specify the  for the UDP port, overriding the compiled-in
        default.
        Only available if compiled with CATCH_UDP_PORT.

      -D|--define [=]
        Add  (optionally to be expanded to ) to the list of
        predefined macros known by the LPC compiler.

      -E|--eval-cost 
        Set the number of  available for one evaluation thread.
        If 0, execution is unlimited.

      -M|--master 
        Use  for the master object.

      -m|--mudlib 
        Use  as the top directory of the mudlib.

      --debug-file 
        Log all debug output in  instead of
        /.debug.log .

      --hostname 
        Use  as hostname instead of what the system says.

      --hostaddr 
        Use  as address of this machine, instead of what the
        system says.  In particular this address will be used to open
        the driver ports.

      --no-compat
      --compat
        Select the mode (plain or compat) of the driver.
        This choice does not affect the default name of the master object.

      -d|--debug
        Generate debug output; repeat the argument for even more output:
          >= 1: log resets, clean ups, swaps, reception of urgend data,
                   telnet negotiation states.
                check_a_lot_of_refcounts() on startup when swapping of
                   variables is disabled.
          >= 2: log all add_message()s, name lookup failures, new players.
          >= 3: progress of garbage collection
          >= 4: even more junk from garbage collection

      -c|--list-compiles
        List the name of every compiled file on stderr.

      -e|--no-preload
        Pass a non-zero argument (the number of occurences of this option)
        to master->preload(), which usually inhibits all preloads of castles
        and other objects.

      --erq 
      --erq " "
        Use  instead of 'erq' as the basename of the ERQ executable.
        If the name starts with a '/', it is take to be an absolute pathname,
        otherwise it is interpreted relative to . If not specified,
        'erq' is used as the executable name.

        By enclosing the argument value in quotes, it is possible to pass
        arguments (e.g. --execdir) to the erq. These arguments however must
        not contain embedded spaces.

      -N|--no-erq
        Don't start the erq demon (if it would be started at all).

      --alarm-time 
        Set the granularity of call_out() and heartbeat timing. Minimum
        value is 1.

      --heart-interval 
        Set the interval between two heartbeats. Minimum value is 1.

      --sync-heart
        All heartbeats occur at the same time (modulo granularity).
      
      --async-heart
        Heartbeats occur when they are due (modulo granularity).

      -t|--no-heart
        Disable heartbeats and call_outs.

      -f|--funcall 
        The lfun master->flag() is called with  as argument before the
        gamedriver accepts netword connections.

      --regexp pcre | traditional
        Select the default regexp package.

      --max-array 
        The maximum number of elements an array can hold.
        Set to 0, arrays of any size are allowed.

      --max-mapping 
        The maximum number of elements a mapping can hold.
        Set to 0, mappings of any size are allowed.

      --max-mapping-keys 
        The maximum number of entries a mapping can hold.
        Set to 0, mappings of any size are allowed.

      --max-callouts 
        The maximum number of callouts at one time.
        Set to 0, any number is allowed.

      --max-bytes 
        The maximum number of bytes one read_bytes()/write_bytes() call
        can handle.
        Set to 0, reads and writes of any size are allowed.

      --max-file 
        The maximum number of bytes one read_file()/write_file() call
        can handle.
        Set to 0, reads and writes of any size are allowed.

      --max-thread-pending \n"
        The maximum number of bytes to be kept pending by the socket write
        thread.
        Set to 0, an unlimited amount of data can be kept pending.

        This option is ignored if pthreads are not used.

      --cleanup-time 
FEEDBACK | IMPRESSUM | DATENSCHUTZ 1992–2019 © MorgenGrauen. Alle Rechte vorbehalten.