Multilink/Configuration

Configuration
=============

    The easiest way to configure Mutlilink is to edit the tooltypes in its
icon.  However, if you wish, you can also specify these options on the
commandline when starting Multilink from the CLI.

    The first thing you need to take care of are the parameters for the
serial port.

    DEVICE
        The name of the serial device you use.  Multilink defaults to
        using "serial.device".

    UNIT
        The unit of the serial device to use.  Multilink defaults to
        0.

    BAUD
        The bps rate to use on the serial port.  Multilink defaults to
        using the rate you set in sys:prefs/serial.

    CTSRTS
        If this specified, Multilink will use CTS/RTS handshaking.  Again,
        by default, Multilink will use it if you have set it in
        sys:prefs/serial as well.

    HISPEED
        If you're using 8bit no parity, you should probably turn this on.
        It activates a lower-overhead mode in the C= serial.device for 8n1
        ports.

    FORCECD
        If you have a wierd wiring on your serial port (ie.  direct
        connect) you may need to set this option to make Multilink ignore
        the state of the carrier line on the port.

    Then you have to tell Multilink about the characteristics of the data
path from your Amiga to the UNIX host.

    CPS
        Set this the the average characters per second you typically get
        over your connection to the UNIX host on a Zmodem download or
        upload.  This is an important option!  Set it too low, and your
        speed will suffer.  Set it too high, and interactive response will
        suffer.  As an example, the typical setting for a 14.4kbps v42bis
        link is about 1500 or 1600.  If you leave this unspecified,
        Multilink will default to 3840 (which is probably wrong for you
        :-)).

    ESCAPE
        This option tells Multilink what bytes NOT to send over the link.
        This is intended to support connections which are not "8bit clean"
        -- that is, they cannot send all the characters 0-255 across the
        link.  The parameter is formatted as follows:

        A colon (:) follow by a two digit hexadecimal number specifies a
        single character which is not to be sent over the link.  ie
        ":1b:41" tells mlink not to send the characters ^[ and 'A' over the
        link.

        A dash followed by a two digit hexadecimal number specifies a range
        of characters that Multilink is not to send.  The range extends
        from the previously specified character to the character currently
        indicated.  ie.  ":1b:41-45:7f" tells Multilink not to send ^[, A
        thru E or the DEL character over the link.

        A single asterisk (*) as the parameter enables a special mode which
        can be used on connections which only allow the printable character
        range to be sent over them.  This mode is used by default if you
        use Multilink over a 7-bit connection.

        A single zero (0) as the parameter tells Multilink that the line is
        perfectly 8bit clean.  Multilink will be able to send all
        characters from 0 to 255 over the link.  This mode is the default
        if Multilink is used over an 8bit connection.

        Note that the more characters you escape, the slower Multilink
        becomes.

    Then you have to tell Multilink how to start "mlink" on the UNIX side.

    UNIXSTARTUP
        This should be set to the command line you would use to start mlink
        on the UNIX host.  ie.  If you keep mlink in your home directory,
        it should be "~/mlink", or if you keep it in a bin directory in
        your account it might be "~/bin/mlink".  Multilink defaults to
        using just "mlink" , which will usually work if the mlink
        executable is in your search path on the UNIX host.