Online Amateur Radio Community Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
=======Section 3 - PZTDOS Commands=======
=====CD=====
<code>CD(3)                   XROUTER REFERENCE MANUAL            16/10/2023
</code> **COMMAND** <code>
        CD -- Change Working Directory (PZTDOS)

</code> **SYNOPSIS** <code>
        CD <[drive:]<dir>

</code> **DESCRIPTION** <code>
        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).

</code> **EXAMPLES** <code>
        CD ../FRED    CD C:\WINDOWS\SYSTEM

</code> **AVAILABILITY** <code>
        This is a sysop-only command, available only within PZTDOS.

</code> **SEE ALSO** <code>
        DOS(1) -- Enter PZTDOS mode

</code>
----
=====COPY=====
<code>COPY(3)                XROUTER REFERENCE MANUAL                5/9/2023
</code> **COMMAND** <code>
        COPY -- Copy file(s) (PZTDOS).

</code> **SYNOPSIS** <code>
        COPY <source> [dest]

</code> **DESCRIPTION** <code>
        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"

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

</code> **PORTABILTY** <code>
        Normal dos syntax is followed, except that concatenation using 
        the "+" operator is not supported.

</code> **AVAILABILITY** <code>
        This command is available only in PZTDOS mode, which is
        restricted to sysops only.

</code> **NOTE** <code>
        Overwrites destination files without warning.

</code> **SEE ALSO** <code>
        DOS(1)  -- Enter PZTDOS mode.
        MOVE(3) -- Move Files (PZTDOS).
        REN(3)  -- Rename files (PZTDOS)..

</code>
----
=====DEL=====
<code>DEL(3)                 XROUTER REFERENCE MANUAL               6/9/2023
</code> **COMMAND** <code>
        DEL -- Delete one or more files (PZTDOS)

</code> **SYNOPSIS** <code>
        DEL <filespec>

</code> **DESCRIPTION** <code>
        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.

</code> **EXAMPLES** <code>
        DEL FRED.TXT
        DEL \TMP\LOG??98.*
        DEL "my big fat pathname.txt"

</code> **AVAILABILITY** <code>
        The DEL command is available only to sysops, in PZTDOS mode.

</code> **SEE ALSO** <code>
        DOS(1) -- Enter PZTDOS mode

</code>
----
=====DF=====
<code>DF(3)                 XROUTER REFERENCE MANUAL                6/9/2023
</code> **COMMAND** <code>
        DF -- Display free space on drive.

</code> **SYNOPSIS** <code>
        DF [drive]

</code> **DESCRIPTION** <code>
        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!

</code> **OPTIONS** <code>
        [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.

</code> **EXAMPLES** <code>
        DF
        DF F:

</code> **AVAILABILITY** <code>
        PZTDOS command.  Only available to sysops.

</code>
----
=====DIR=====
<code>DIR(3)                XROUTER REFERENCE MANUAL               21/2/2013
</code> **COMMAND** <code>
        DIR -- Obtain a directory listing. (PZTDOS)

</code> **SYNOPSIS** <code>
        DIR [[path/]mask]

</code> **DESCRIPTION** <code>
        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.

</code> **EXAMPLES** <code>
        DIR MSGHDR??.*
        DIR LOG\
        DIR /pub\DOCS\*.TXT
        DIR "test directory/*.txt"

</code> **LIMITATIONS** <code>
        Does not at present accept pipes, redirection or switches.

</code> **AVAILABILITY** <code>
        Restricted to sysops. Available only within PZTDOS mode.

</code> **SEE ALSO** <code>
        DOS(1) -- Enter PZTDOS mode.

</code>
----
=====EDIT=====
<code>EDIT(3)                XROUTER REFERENCE MANUAL               6/9/2023
</code> **COMMAND** <code>
        EDIT -- Invoke Line Editor (PZTDOS).

</code> **SYNOPSIS** <code>
        E[DIT] [drive:][path/]<filename>

</code> **AVAILABILITY** <code>
        Sysop only. PZTDOS mode only.

</code> **DESCRIPTION** <code>
        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.

</code> **OPTIONS** <code>
        [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".

</code> **EXAMPLES** <code>
        EDIT "C:\MyStuff/My Docs/Diary.txt"
        EDIT XROUTER.CFG
        EDIT help/chat.hlp

</code> **OPERATION** <code>
        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)

</code> **CAVEATS** <code>
        The editor can access any part of any disk, so it must be
        used with caution.

</code>
----
=====EXIT=====
<code>EXIT(3)               XROUTER REFERENCE MANUAL                6/9/2023
</code> **COMMAND** <code>
        EXIT -- Leave PZTDOS mode

</code> **SYNOPSIS** <code>
        EXIT

</code> **AVAILABILITY** <code>
        The EXIT command is available only to sysops, within PZTDOS.

</code> **DESCRIPTION** <code>
        Closes a PZTDOS session and returns to normal command mode.

</code> **NOTE** <code>
        There is also an EXIT command outside PZTDOS, which is used
        to terminate the program.

</code> **SEE ALSO** <code>
        DOS(1)  -- Enter PZTDOS mode.
        EXIT(1) -- Exit XRouter

</code>
----
=====MD=====
<code>MD(3)                   XROUTER REFERENCE MANUAL            16/10/2023
</code> **COMMAND** <code>
        MD -- Make Directory. (PZTDOS)

</code> **SYNOPSIS** <code>
        MD [drive:][path\]<dirname>

</code> **DESCRIPTION** <code>
        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.  

</code> **EXAMPLES** <code>
        MD fred                    Make subdirectory FRED
        MD d:\usr\pub\packet       Make directory on specified drive.

</code> **AVAILABILITY** <code>
        Within PZTDOS mode only.  Non-sysops do not have access to
        this command.

</code> **PORTABILITY** <code>
        This command is identical to the MSDOS version.

</code> **SEE ALSO** <code>
        RMDIR(3) -- Remove Directory.

</code>
----
=====MOVE=====
<code>MOVE(3)                 XROUTER REFERENCE MANUAL            16/10/2023
</code> **COMMAND** <code>
        MOVE -- Move file(s). (PZTDOS)

</code> **SYNOPSIS** <code>
        MOVE [drive:][path\]<filename1> [drive:][path\][filename2]

</code> **AVAILABILITY** <code>
        Within PZTDOS mode only.  Non-sysops do not have access to
        this command.

</code> **DESCRIPTION** <code>
        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".

</code> **EXAMPLES** <code>
        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

</code> **PORTABILITY** <code>
        This command follows normal MSDOS v 7 syntax, apart from the 
        ability to rename a directory, which is not implemented.

</code> **SEE ALSO** <code>
        COPY(3) -- Copy files (PZTDOS).
        DOS(1)  -- Enter PZTDOS mode
        REN(3)  -- Rename files (PZTDOS).

</code>
----
=====REN=====
<code>REN(3)                  XROUTER REFERENCE MANUAL            18/10/2023
</code> **COMMAND** <code>
        REN -- Rename file(s). (PZTDOS)

</code> **SYNOPSIS** <code>
        REN [drive:][path\]<oldname> [drive:][path\]<newname>

</code> **DESCRIPTION** <code>
        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".

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

</code> **LIMITATIONS** <code>
        Source and destination pathnames must be on the same drive.  
        (Use the MOVE command for renaming to a different drive)

</code> **PORTABILITY** <code>
        This command follows normal DOS syntax.

</code> **AVAILABILITY** <code>
        REN is available within PZTDOS mode only.  Non-sysops do not
        have access to PZTDOS.

</code> **SEE ALSO** <code>
        DOS(1)  -- Enter PZTDOS mode.
        MOVE(3) -- Move a file with optional rename.

</code>
----
=====RMDIR=====
<code>RMDIR(3)                XROUTER REFERENCE MANUAL            17/10/2023
</code> **COMMAND** <code>
        RMDIR -- Remove Directory. (PZTDOS)

</code> **SYNOPSIS** <code>
        RMDIR [drive:][path\]<dirname>

</code> **AVAILABILITY** <code>
        Sysop-only, within PZTDOS only.

</code> **DESCRIPTION** <code>
        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. 

</code> **EXAMPLES** <code>
        RMDIR fred             Delete subdirectory FRED
        RMDIR c:\windows       Improve your system!!

</code> **SEE ALSO** <code>
        MD(3) -- Make Directory.

</code>
----
=====TYPE=====
<code>TYPE(3)                 XROUTER REFERENCE MANUAL            17/10/2023
</code> **COMMAND** <code>
        TYPE -- displays a text file. (PZTDOS)

</code> **SYNOPSIS** <code>
        TYPE [path/]<filename>

</code> **AVAILABILITY** <code>
        Sysop-only. PZTDOS mode only.

</code> **DESCRIPTION** <code>
        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" 

</code> **EXAMPLE** <code>
        TYPE ../DOCS/FRED.TXT

</code> **LIMITATIONS** <code>
        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.
        
</code> **PORTABILITY** <code>
        The TYPE command in PZTDOS follows normal DOS syntax, apart 
        from the lack of redirection mentioned in "limitations".

</code> **SEE ALSO** <code>
        DOS(1) -- Enter PZTDOS mode

</code>
----