======Section 3 - PZTDOS Commands====== ==== CD ==== CD(3) XROUTER REFERENCE MANUAL 16/10/2023 **COMMAND** CD -- Change Working Directory (PZTDOS) **SYNOPSIS** CD <[drive:] **DESCRIPTION** The CD command changes the "working directory" to the one specified by . If 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 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 ==== COPY(3) XROUTER REFERENCE MANUAL 5/9/2023 **COMMAND** COPY -- Copy file(s) (PZTDOS). **SYNOPSIS** COPY [dest] **DESCRIPTION** The COPY command copies the file(s) specified by the pathname into the file(s) or directory specified by [dest]. may be 'CON', a directory, a single file, or multiple files specified using wildcards, and may contain a drive and path spec. If is a directory, all the files in that directory will be copied. If contains wildcards, all matching files will be copied. If is 'CON' any further keyboard input is written to a new file specified by . 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 ==== DEL(3) XROUTER REFERENCE MANUAL 6/9/2023 **COMMAND** DEL -- Delete one or more files (PZTDOS) **SYNOPSIS** DEL **DESCRIPTION** If 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 ==== 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 ==== 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 ==== EDIT(3) XROUTER REFERENCE MANUAL 6/9/2023 **COMMAND** EDIT -- Invoke Line Editor (PZTDOS). **SYNOPSIS** E[DIT] [drive:][path/] **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 -- Append line 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 -- Insert 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 [] -- Write (save) file being edited to disk. If is specified, the work is written there instead of the original name, but will not overwrite an existing file. W! -- Write unconditionally. Writes the text being edited to , 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 ==== 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 ==== MD(3) XROUTER REFERENCE MANUAL 16/10/2023 **COMMAND** MD -- Make Directory. (PZTDOS) **SYNOPSIS** MD [drive:][path\] **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. 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 ==== MOVE(3) XROUTER REFERENCE MANUAL 16/10/2023 **COMMAND** MOVE -- Move file(s). (PZTDOS) **SYNOPSIS** MOVE [drive:][path\] [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 ==== REN(3) XROUTER REFERENCE MANUAL 18/10/2023 **COMMAND** REN -- Rename file(s). (PZTDOS) **SYNOPSIS** REN [drive:][path\] [drive:][path\] **DESCRIPTION** Renames one or more file(s) from to . 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 ==== RMDIR(3) XROUTER REFERENCE MANUAL 17/10/2023 **COMMAND** RMDIR -- Remove Directory. (PZTDOS) **SYNOPSIS** RMDIR [drive:][path\] **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 ==== TYPE(3) XROUTER REFERENCE MANUAL 17/10/2023 **COMMAND** TYPE -- displays a text file. (PZTDOS) **SYNOPSIS** TYPE [path/] **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 ----