NitrOS-9 Commands Reference

asm

Syntax:	asm filename [option(s)] [#memsize] [>listing]
Usage:
Opts:
	C	Conditionals on - displays conditional assembly statements in the listing. (C)
	Dnum	Page Depth - sets the number of lines per listing page, including heading and blank line. (D66)
	E	Error Message On - displays error messages in listing. When this option is off, an E appears in a statement's informational field if an error is present. (E)
	F	Use Form Feed - uses a form feed for page eject instead of line feeds. (-F)
	G	Generate All Constant Lines -- displays all lines of code generated by pseudo instructions. Otherwise, it displays only the first line. (-G)
	L	Listings On - generates formatted assembly listing. If off, the assembler displays only error messages. (-L)
	M	Mode On - turns on Motorola-compatible mode. (-M)
	N	Narrow Listing - generates listing in a non-columnized, compressed format for better presentation on narrow display devices. (-N)
	O[=filename]	Generates object object file. (-O) If you do not specify a file name, the assembler creates an object file having the same name as the input file in the current execution directory. If you specify a single name, assembler creates an object file having that name but still in the current execution directory. If you specify a full pathlist, the assembler uses it as the name specification of the device, directory, and file to create.
	S	Generate Symbol Table -- displays the entire contents of the symbol table at the end of the assembly. Displays each name, its value, and a type code character: D = data variable (RMB definitions) E = equate label (EQU) L = program label S = set label U = undefined name. The table is displayed across the page in alphabetical order. (-S)
	Wnum	Set Page Width -- defines the maximum length of each listing line. Lines are truncated if they exceed this number. The comment field starts at column 50; therefore, a number smaller than this may cause important parts of the listing to be lost. (W80)

attr

Syntax:	attr filename [<opts>] [<perms>]
Usage:	Examine or change the security permissions of a file
Opts:
-perm	turn off specified permission
perm	turn on specified permission
-a	inhibit printing of attrs after change
Perms:
d	directory file
s	non-sharable file
r	read permit to owner
w	write permit to owner
e	execute permit to owner
pr	read permit to public
pw	write permit to public
pe	execute permit to public

backup

Syntax:	backup [<opts>] [<srcdev>] [<destdev>]
Usage:	Copies all data from one device to another
Opts:
e	exit if read error occurs
s	single disk backup
-v	do not verify writes

binex

Syntax:	binex <path1> <path2>
Usage:	Convert binary to S-record format

build

Syntax:	build <path>
Usage:	Builds short text files from standard input

calldbg

Syntax:
Usage:
Opts:

cmp

Syntax:	cmp <path1> <path2>
Usage:	File comparison utility

cobbler

Syntax:	cobbler <devname>
Usage:	Creates NitrOS-9 boostrap file from current boot

copy

Syntax:	copy [<opts>] <srcpath> [<dstpath>] [<opts>]
Usage:	Copies files
Opts:
-a	abort on error
-p	don't print files copied (use with -w)
-r	rewrite destination
-s	single drive copy
-v	verify the copy
-w=<dir>	copy to <dir>
-x	copy from execution directory

cputype

Syntax:	cputype
Usage:	Displays type of CPU being used

date

Syntax:	date [<opts>]
Usage:	Displays current system date
Opts:
-t	display time also

dcheck

Syntax:	dcheck [<opts>] <devname>
Usage:	Check disk file structure
Opts:
-w=<path>	pathlist to directory for work files
-p	print pathlists for questionable clusters
-m	save allocation map work files
-b	suppress listing of unused clusters
-s	display count of files and directories only
-o	print options for dcheck

debug

Syntax:	debug
Usage:	Interactive debugger

ded

Syntax:	ded </device>
Usage:	Binary disk editor

deiniz

Syntax:	deiniz <devname> {<devname>}
Usage:	Detach one more devices

del

Syntax:	del [<opts>] <path> [<path>] [<opts>]
Usage:	Deletes one or more files
Opts:
-x	delete relative to execution directory

deldir

Syntax:	deldir <path>
Usage:	Deletes entire directories

devs

Syntax:	devs
Usage:	Displays IOMan's device table entries

dir

Syntax:	dir [<opts>] [<path>]
Usage:	Displays formatted list of the file names in a directory
Opts:
-e	extended directory listing
-x	execution directory

dirsort

Syntax:
Usage:
Opts:

disasm

Syntax:	disasm [<opts>] [<pathlist>]
Usage:	6809/6309 disassembler
Opts:
-m	disassemble module in memory
-o	display other information
-s$ssss$eeee	indicate disassembly start and end addresses
-u	don't convert U/DP offsets to labels
-x	file is in execution directory
-z	disassemble from standard input

display

Syntax:	display <opts>
Usage:	Displays converted characters to standard output
Opts:
xx	hexademical
.xx	decimal byte
.Wxx	decimal word
/xx/	string
"xx"	string

dmem

Syntax:	-<id>] <offset> [<length>]
Usage:	Displays raw memory from a block or offset.	Often piped through 'dump', for example: dmem 0 0 100 ! dump

dmode

Syntax:	dmode <devname> [<opts>]
Usage:	Displays or changes the parameters of an RBF device

dsave

Syntax:	dsave [<opts>] [<pathlist>]
Usage:	Generates procedure file to copy all files from the current directory to <pathlist>
Opts:
-b	make a system disk by using OS9Boot if present
-b=<path>	make system disk using <path> as source
-i	indent for directory levels
-l	do not process below the current directory level
-m	do not include makdir commands in procedure file
-r	force rewrite of file on copy
-s<num>	set copy size to <num>K
-v	verify copies

dump

Syntax:	dump [<opts>] [<path>] [<opts>]
Usage:	Formatted file dump in hexadecimal and ASCII
Opts:
-h	no header
-m	module in memory
-x	file in execution directory

echo

Syntax:	echo <text>
Usage:	Echo entered text to standard output

edit

Syntax:	edit [<path>]
Usage:	Standard line-oriented text editor

error

Syntax:	error [<errno>] [<errno> [...]]
Usage:	Outputs text error messages for given error numbers

exbin

Syntax:	exbin <path1> <path2>
Usage:	Converts S-Record format to binary

format

Syntax:	format <devname> [<opts>]
Usage:	Initializes a NitrOS-9 diskette
Opts:
R	Ready
L	Logical format only
	"disk name"
1/2	number of sides
	'No. of cylinders' (in decimal)
	:Interleave value: (in decimal)
	/Cluster size/ (in decimal)

free

Syntax:	free [<devname>]
Usage:	Displays number of free sectors on device

grfdrv

Syntax:	none
Usage:	Graphics driver module that needs to be loaded to handle graphics/windowing commands

help

Syntax:	help [<subject>] [<opts>]
Usage:	Gives online help to user and prompts if no subjects given

ident

Syntax:	ident [<opts>] <path> [<opts>]
Usage:	Displays header information of NitrOS-9 memory modules
Opts:
-m	module in memory
-s	short form
-v	don't verify CRC
-x	file in execution directory

iniz

Syntax:	iniz <devname> [<devname> [...]]
Usage:	Attaches one or more devices

irqs

Syntax:	irqs
Usage:	Displays interrupt table entries

link

Syntax:	link <modname>
Usage:	Links to a memory module

list

Syntax:	list <path> [<path> [...]]
Usage:	Lists the contents of text files

load

Syntax:	load <pathlist> [<pathlist> [...]]
Usage:	Loads modules into memory

login

Syntax:	login
Usage:	Timesharing system login

makdir

Syntax:	makdir <pathlist>
Usage:	Creates a new directory file

megaread

Syntax:	megaread </dev>
Usage:	Measures disk performance

mdir

Syntax:	mdir [<opts>]
Usage:	Displays the present memory module directory
Opts:
-e	prints extended module directory

merge

Syntax:	merge <path> [<path> [...]]
Usage:	Copies multiple input files to standard output
Opts:
-z	gets list of files from standard input

mfree

Syntax:	mfree
Usage:	Displays the amount of free memory
See also:	free smap mmap

mmap

Syntax:	mmap
Usage: (Level 2)	Displays the NitrOS-9 memory map. Memory is accessed though the DAT or other memory-mapping hardware. Blocks, typically 8Kbytes in size, are mapped into the processor's 64Kbyte address space. smap shows which of these blocks is allocated and many free blocks are available.
See also:	mfree smap

mpi

Syntax:	mpi
Usage:	Displays the presence of a Multi-Pak Interface

os9gen

Syntax:	os9gen devnam [<opts>]
Usage:	Creates and links a NitrOS-9 bootstrap file
Opts:
-s	single drive option
-t=<boottrack>	boot track file to use

padrom

Syntax:	padrom <padsize> <pathlist> [<devname>] [<opts>]
Usage:	Pads a file to <padsize> bytes
Opts:
-c=<char>	character to pad the file with (in hexadecimal)

park

Syntax:	park <devname> [<devname> [...]]
Usage:	Parks the heads on a hard disk drive

printerr

Syntax:
Usage:
Opts:

proc

Syntax:	procs [<opts>]
Usage: (Level 2)	Displays a list of processes running in the system. Like procs but provides some additional information.
See also:	procs

procs

Syntax:	procs [<opts>]
Usage:	Displays a list of processes running in the system
Opts:
-e	displays all processes in the system
See also:	proc

prompt

Syntax:	prompt <message>
Usage:	Prints <message> and waits for a key

pwd

Syntax:	pwd
Usage:	Prints the path to the current working directory

pxd

Syntax:	pxd
Usage:	Prints the path to the current execution directory
Opts:

rename

Syntax:	rename <pathlist> <filename>
Usage:	Gives the file or directory a new name

save

Syntax:	save <path> <modname> [<modname> [...]]
Usage:	Saves the memory module(s) to a file

setime

Syntax:	setime [yyyy/mm/dd hh:mm:ss]
Usage:	Sets and activates the system clock

shellplus

Syntax:
Usage:
Opts:

shell

Syntax:	shell [<arglist>]
Usage:	NitrOS-9 command interpreter

sleep

Syntax:	sleep <ticks>
Usage:	Suspends the current process for a period of time

smap

Syntax:	smap
Usage: (Level 2)	Displays the NitrOS-9 system memory map. Memory within the processor's 64Kbyte address space is allocated in units of 256byte 'pages'. smap shows how these pages are allocated.
See also:	mfree mmap

tee

Syntax:	tee [<path>]
Usage:	Copy the standard input to multiple output paths

tmode

Syntax:	tmode [<path>] [<opts>]
Usage:	Displays or changes the operating parameters of the terminal

touch

Syntax:	touch [<opts>] <path> [<opts>]
Usage:	Updates the date of a file
Opts:
-c	don't create files
-q	don't quit on error
-x	search execution directory
-z	get files from standard input
-z=<file>	get files from <file>

tsmon

Syntax:	tsmon [<pathlist>]
Usage:	Timesharing monitor

tuneport

Syntax:	tuneport <device> <value>
Usage:	Adjusts the baud value for the serial port

unlink

Syntax:	unlink <modname> [<modname> [...]]
Usage:	Unlinks one or more modules from memory

verify

Syntax:	verify [<opts>]
Usage:	Verifies or updates the module header and CRC
Opts:
-u	update the module CRC

xmode

Syntax:	xmode <devname> [<opts>]
Usage:	Displays or changes the parameters of an SCF device

inetd

Syntax:
Usage:
Opts:

telnet

Syntax:
Usage:
Opts:

dw

Syntax:
Usage:
Opts:

basic09

Syntax:	basic09
Usage:	Basic language interpreter

runb

Syntax:	runb <i-code module>
Usage:	Basic09 run-time package

gfx

Syntax:	RUN GFX(<func>,<args>)
Usage:	Graphics interface package for Basic09 to do compatible VDG graphics commands

inkey

Syntax:	RUN INKEY([path], strvar)
Usage:	Basic09 subroutine to input a single keystroke

syscall

Syntax:
Usage:
Opts: