CD(3)                   XROUTER REFERENCE MANUAL            16/10/2023

COMMAND

        CD -- Change Working Directory (PZTDOS)

SYNOPSIS

        CD <[drive:]<dir>

DESCRIPTION

        The CD command changes the "working directory" to the one 
        specified by <dir>.  

        If <dir> is an absolute pathname, beginning with \ or /, it
        is used as specified, otherwise it is interpreted relative to 
        the current working directory.  The command recognises "."
        and  "..", and both forward and reverse slashes may be freely 
        mixed.

        On DOS (XR16) and Windows (XR32) versions only, if <dir> is 
        preceeded by a drive spec tPZTDOS will also change 
        the current drive (not applicable on Linux).

EXAMPLES

        CD ../FRED    CD C:\WINDOWS\SYSTEM

AVAILABILITY

        This is a sysop-only command, available only within PZTDOS.

SEE ALSO

        DOS(1) -- Enter PZTDOS mode

COPY(3)                XROUTER REFERENCE MANUAL                5/9/2023

COMMAND

        COPY -- Copy file(s) (PZTDOS).

SYNOPSIS

        COPY <source> [dest]

DESCRIPTION

        The COPY command copies the file(s) specified by the pathname 
        <source> into the file(s) or directory specified by [dest].

        <source> may be 'CON', a directory, a single file, or multiple 
        files specified using wildcards, and may contain a drive and 
        path spec.  If <source> is a directory, all the files in that 
        directory will be copied.  If <source> contains wildcards, all 
        matching files will be copied.

        If <source> is 'CON' any further keyboard input is written to
        a new file specified by <dest>. The operation is terminated,
        and the file written out, upon receipt of a line containing
        only /EX or ctrl-Z. The operation can be aborted at any time
        by entering a new line containing only ctrl-A. Nothing is
        written to disk in this case.  
                
        [dest] may be a directory, a single file, or blank.  If [dest] 
        is a directory, the source file(s) are copied into it as 
        seperate files.  If [dest] is a single file, the source 
        file(s) are concatenated into it.  If [dest] is not specified, 
        the file is copied into the working directory and retains the 
        original filename.

        Pathnames may use either forward (/) or back (\) slashes.

        Pathnames that contain spaces must be enclosed in double
        quotes, e.g. "my documents/daily report"

EXAMPLES

        COPY ..\MYPROG.EXE   /progs/TESTPROG.EXE                 
        COPY "my documents/rfc793"  /reference
        COPY *.HLP  HELP.DOC
        COPY CON fred.txt

PORTABILTY

        Normal dos syntax is followed, except that concatenation using 
        the "+" operator is not supported.

AVAILABILITY

        This command is available only in PZTDOS mode, which is
        restricted to sysops only.

NOTE

        Overwrites destination files without warning.

SEE ALSO

        DOS(1)  -- Enter PZTDOS mode.
        MOVE(3) -- Move Files (PZTDOS).
        REN(3)  -- Rename files (PZTDOS)..

DEL(3)                 XROUTER REFERENCE MANUAL               6/9/2023

COMMAND

        DEL -- Delete one or more files (PZTDOS)

SYNOPSIS

        DEL <filespec>

DESCRIPTION

        If <filespec> describes one or more files, they are deleted.

        Pathnames containing spaces must be enclosed in quotes.

        Both forward (/) and back (\) slashes are accepted.

        The number of files deleted is reported upon completion.

EXAMPLES

        DEL FRED.TXT
        DEL \TMP\LOG??98.*
        DEL "my big fat pathname.txt"

AVAILABILITY

        The DEL command is available only to sysops, in PZTDOS mode.

SEE ALSO

        DOS(1) -- Enter PZTDOS mode

DF(3)                 XROUTER REFERENCE MANUAL                6/9/2023

COMMAND

        DF -- Display free space on drive.

SYNOPSIS

        DF [drive]

DESCRIPTION

        The DF command displays the free and total space in bytes on 
        the specified drive, plus sector and cluster size information.

        WARNING: This currently gives incorrect information on Linux!

OPTIONS

        [drive] is only applicable on XR16 and XR32. It is ignored
        on Linux versions.

        If no drive is specified, the current drive is assumed.

        The drive letter need not include the colon.

EXAMPLES

        DF
        DF F:

AVAILABILITY

        PZTDOS command.  Only available to sysops.

DIR(3)                XROUTER REFERENCE MANUAL               21/2/2013

COMMAND

        DIR -- Obtain a directory listing. (PZTDOS)

SYNOPSIS

        DIR [[path/]mask]

DESCRIPTION

        The DIR command lists the contents of the specified directory 
        using the optional specified mask.

        If a path is not specified, the "current working directory"
        is assumed. Forward and backward slashes can be freely mixed. 

        If mask is not specified, "*.*" is assumed.  If only the 
        filename part is specified, the extension ".*" is assumed.

        Path[/mask] arguments containing spaces MUST be enclosed in
        "double quotes".

        The files are displayed in alphabetical order.

EXAMPLES

        DIR MSGHDR??.*
        DIR LOG\
        DIR /pub\DOCS\*.TXT
        DIR "test directory/*.txt"

LIMITATIONS

        Does not at present accept pipes, redirection or switches.

AVAILABILITY

        Restricted to sysops. Available only within PZTDOS mode.

SEE ALSO

        DOS(1) -- Enter PZTDOS mode.

EDIT(3)                XROUTER REFERENCE MANUAL               6/9/2023

COMMAND

        EDIT -- Invoke Line Editor (PZTDOS).

SYNOPSIS

        E[DIT] [drive:][path/]<filename>

AVAILABILITY

        Sysop only. PZTDOS mode only.

DESCRIPTION

        The EDIT command invokes the text editor, allowing text
        files to be created, viewed or edited.

        This is a line-based text editor which is primarily of use
        to remote sysops.

        If the specified file doesn't exist, it will be created.

        All editing is done in memory, and the original file is only
        created or modified when the sysop issues a write command.

OPTIONS

        [drive:] is only meaningful for DOS and Windows versions.
        For Linux, ignore all references to it.

        Backslashes are used on DOS and Windows, forward slashes on
        Linux, although they can be freely mixed.

        If no drive or path are specified, the XRouter "working
        directory" is assumed.

        If the drive is not specified, the drive containing XRouter
        is assumed.

        If the path starts with a backslash (\), it is relative to
        the root of the drive, otherwise it is relative to the
        XRouter directory.

        Pathnames containing spaces must be enclosed in "double
        quotes".

EXAMPLES

        EDIT "C:\MyStuff/My Docs/Diary.txt"
        EDIT XROUTER.CFG
        EDIT help/chat.hlp

OPERATION

        In the following, n1, n2 and n3 refer to line numbers, which
        must be greater than zero, and within the range of line
        numbers used in the file.  The space between the command and
        the first number may be omitted, and the numbers may be
        separated by spaces, commas, colons, tabs etc.   Parameters
        in square brackets [] are optional.  When copying, moving or
        inserting lines, the "source" text is inserted at the
        "destination" line, i.e. "in front of" the original text.


        ? -- Displays a brief list of commands.

        A <text> -- Append line <text> to the file.

            The editor ignores exactly one space between the A and 
            the text to be inserted, so if you want to enter a line 
            with leading spaces, add one extra.

        C n1 n2 [n3] -- Copy line(s).

            If n3 is omitted, line n1 is copied into line n2, 
            otherwise the block n1 to n2 inclusive will be copied 
            into the position beginning at n3.
            Note: n3 must not be within the block being copied.

        D n1 [n2] -- Delete line(s).

            If both n1 and n2 are specified, the block of lines 
            between and including n1 and n2 will be deleted.  If n2 
            is omitted, or is the same as n1, only n1 will be 
            deleted.

        H n1 -- Hash (comment-out) a line using the '#' symbol.
              
            This is useful for disabling configuration entries 
            without deleting them.  They can be easily re-activated 
            at a later date using the U)nhash command.  If the line 
            already begins with '#' another one is not prepended.

        I n1 <text> -- Insert <text> into line n1.

        L n1 [n2] -- List (display) line(s).

            If n2 is specified, lines n1 to n2 inclusive will be 
            displayed, otherwise it will display 10 lines beginning 
            at n1.  If n1 is omitted, it will re-display the same 
            page, or if this is the first time the command has been 
            used, the first 10 lines of the text will be displayed.

        M n1 n2 [n3] -- Move line(s).

            If n3 is specified, the block of lines n1 to n2 
            inclusive will be moved to the position beginning at 
            n3, otherwise the single line n1 will be moved to the 
            n2 position.

        N -- Next page.

            Displays the next page (10 lines) of text.

        P -- Previous page.

            Displays the previous page (10 lines) of text.

        Q -- Quit.

            The text is abandoned and the original file is
            left intact, providing you hadn't used the W command.

        S -- Save the text.
            Syntax and function identical to W)rite.

        U n1 -- Unhash line n1.

            Removes a '#' symbol from start of line, if one is 
            present (opposite of H)ash).

        W [<file>] -- Write (save) file being edited to disk.

            If <file> is specified, the work is written there 
            instead of the original name, but will not overwrite an 
            existing file.

        W! <file> -- Write unconditionally.

            Writes the text being edited to <file>, overwriting any
            existing file of that name.

        WQ -- Write & Quit.

            Writes the modified text back to the original file and
            quits editor. (Same as ZZ)

        ZZ -- Same as WQ (see above)

CAVEATS

        The editor can access any part of any disk, so it must be
        used with caution.

EXIT(3)               XROUTER REFERENCE MANUAL                6/9/2023

COMMAND

        EXIT -- Leave PZTDOS mode

SYNOPSIS

        EXIT

AVAILABILITY

        The EXIT command is available only to sysops, within PZTDOS.

DESCRIPTION

        Closes a PZTDOS session and returns to normal command mode.

NOTE

        There is also an EXIT command outside PZTDOS, which is used
        to terminate the program.

SEE ALSO

        DOS(1)  -- Enter PZTDOS mode.
        EXIT(1) -- Exit XRouter

MD(3)                   XROUTER REFERENCE MANUAL            16/10/2023

COMMAND

        MD -- Make Directory. (PZTDOS)

SYNOPSIS

        MD [drive:][path\]<dirname>

DESCRIPTION

        MD creates a directory with the specified pathname.

        If drive or path are not specified, the current working drive 
        and/or path are assumed.

        The specified path may be absolute, or relative to the current 
        directory. Forward (/) and back (\) slashes may be freely
        mixed.

        [drive:] is only valid for DOS (XR16) and Windows (XR32)
        versions. <pathname> is case sensitive in Linux (XRLin / XRPi)
        versions ony.  

EXAMPLES

        MD fred                    Make subdirectory FRED
        MD d:\usr\pub\packet       Make directory on specified drive.

AVAILABILITY

        Within PZTDOS mode only.  Non-sysops do not have access to
        this command.

PORTABILITY

        This command is identical to the MSDOS version.

SEE ALSO

        RMDIR(3) -- Remove Directory.

MOVE(3)                 XROUTER REFERENCE MANUAL            16/10/2023

COMMAND

        MOVE -- Move file(s). (PZTDOS)

SYNOPSIS

        MOVE [drive:][path\]<filename1> [drive:][path\][filename2]

AVAILABILITY

        Within PZTDOS mode only.  Non-sysops do not have access to
        this command.

DESCRIPTION

        Moves the file(s) specified by the first argument (source) to 
        the new location and/or name(s) specified by the second 
        argument (target).  Both filenames may contain wildcards.

        "source" must not be a directory.  If it doesn't contain a 
        path, the current working directory is assumed.

        "target" may be a directory.  If a filename is not specified, 
        the original name(s) are used.  If target is a single file, 
        the source must also be a single file.

        If source and target filenames are different the file(s) will 
        be renamed at the same time.

        [drive:] is only applicable to DOS (XR16) Windows (XR32)
        versions. Linux pathnames are case-sensitive, but those of
        DOS/Windows are not. Fortward (/) and back (\) slashes may be
        freely mixed.

        Pathnames which contain spaces must be enclosed in double
        quotes, e.g. "this is a pathname with spaces".

EXAMPLES

        MOVE fred.bat test.bat               Rename only.
        MOVE test.bat c:\                    Move only.
        MOVE c:\test.bat d:\tmp\fred.bat     Move with rename.
        MOVE fred.txt "my docs/"             Path with spaces

PORTABILITY

        This command follows normal MSDOS v 7 syntax, apart from the 
        ability to rename a directory, which is not implemented.

SEE ALSO

        COPY(3) -- Copy files (PZTDOS).
        DOS(1)  -- Enter PZTDOS mode
        REN(3)  -- Rename files (PZTDOS).

REN(3)                  XROUTER REFERENCE MANUAL            18/10/2023

COMMAND

        REN -- Rename file(s). (PZTDOS)

SYNOPSIS

        REN [drive:][path\]<oldname> [drive:][path\]<newname>

DESCRIPTION

        Renames one or more file(s) from <oldname> to <newname>.

        If the source path is not specified, the current working 
        directory is assumed.

        If the destination path is not specified, the renamed file(s) 
        remain(s) in the source directory.

        If you specify two different paths, this command moves the 
        file to the new path, providing it is on the same drive.

        Filenames may contain wildcards. Pathnames on Linux are case-
        sensitive. Those on DOS and Windows are not.

        [drive:] is only applicable to DOS and Windows versions of
        XRouter. 

        Forward (/) and back (\) slashes are interchangeable.

        Pathnames containing spaces must be enclosed in double quote
        marks, e.g. "my documents".

EXAMPLES

        REN  FWD.SYS  FWD.OLD
        REN  C:\AUTOEXEC.BAT  AUTOEXEC.BAK
        REN  C:\TMP\FRED.DOC  \JUNK/JILL.DOC
        REN  *.SAV *.19

LIMITATIONS

        Source and destination pathnames must be on the same drive.  
        (Use the MOVE command for renaming to a different drive)

PORTABILITY

        This command follows normal DOS syntax.

AVAILABILITY

        REN is available within PZTDOS mode only.  Non-sysops do not
        have access to PZTDOS.

SEE ALSO

        DOS(1)  -- Enter PZTDOS mode.
        MOVE(3) -- Move a file with optional rename.

RMDIR(3)                XROUTER REFERENCE MANUAL            17/10/2023

COMMAND

        RMDIR -- Remove Directory. (PZTDOS)

SYNOPSIS

        RMDIR [drive:][path\]<dirname>

AVAILABILITY

        Sysop-only, within PZTDOS only.

DESCRIPTION

        Deletes a directory with the specified pathname, if it exists.

        If drive or path are not specified, the current working drive 
        and/or path are assumed.

        The specified path may be absolute, or relative to the current 
        directory.

        [drive:] is applicable only to DOS and Windows versions.

        Pathnames are case sensitive in Linux versions only.

        Forward (/) and back (\) slashes may be used interchangeably. 

EXAMPLES

        RMDIR fred             Delete subdirectory FRED
        RMDIR c:\windows       Improve your system!!

SEE ALSO

        MD(3) -- Make Directory.

TYPE(3)                 XROUTER REFERENCE MANUAL            17/10/2023

COMMAND

        TYPE -- displays a text file. (PZTDOS)

SYNOPSIS

        TYPE [path/]<filename>

AVAILABILITY

        Sysop-only. PZTDOS mode only.

DESCRIPTION

        The TYPE command displays the specified text file without 
        pagination.

        Forward (/) and back (\) slashes may be used interchangeably.

        Pathnames containing spaces must be enclosed in double
        quoutes (e.g. "my documents/fred and mary.txt" 

EXAMPLE

        TYPE ../DOCS/FRED.TXT

LIMITATIONS

        For use with text files only.  There are no limitations on the 
        size of file which can be displayed.  The command does not 
        (yet) allow concatenation of files, and the output may not 
        (yet) be redirected to a file.
        Wildcards are not accepted.
        

PORTABILITY

        The TYPE command in PZTDOS follows normal DOS syntax, apart 
        from the lack of redirection mentioned in "limitations".

SEE ALSO

        DOS(1) -- Enter PZTDOS mode