A2osX/.Docs/Command Guide.md
Patrick Kloepfer 47702d610c Updated doc.
2019-03-23 20:36:51 -04:00

7.0 KiB

A2osX Command Guide

This Guide provides information on all the A2osX commands and utilities. This Guide helps you not only learn the purpose of each command but also what options a command supports and what arguments it either supports or requires.

A2osX comes with a nice variety of system, file, network and data utilities or what we refer to as external commands. This just means that each of the following commands or utilities is built as a separate BIN or executable file that runs under A2osX. The source for all of these external commands is readily available, so you can make your own as your needs dictate. Note, that there are some internal commands that are build into the shell (the interactive prompt) such CD (change directory) or PWD (print working directory). Those commands are discussed in-depth in the Shell Developers Guide.

System Commands

You will usually not use these commands, they are more commonly found in A2osX system scripts such as ./ETC/INIT or they are launched by the A2osX Kernel itself. All of these commands are found in ./SBIN/ letting you know they are special system commands.

GETTY

Command Options
GETTY -E : Exit upon disconnect

INSDRV

Command
INSDRV Driver

KCONFIG

Command
KCONFIG

Kernel Configuration Utility writes to ${ROOT}/A2OSX.KCONFIG.

LOGIN

Command
INSDRV Driver

SH

Command
SH Script

INITD

Command
INITD InitLevel

BIN,External Shell commands:

CAT

Command Options
CAT -A : Show All non printable caracters
-N : Number all output lines
-S : Suppress repeated empty output lines

The CAT command is used to display the contents of files stored on any ProDOS volume. While the primary use of this tool is to display the contents of TEXT or TXT files, it can be used to display the contents of other files by using the -A option, which will substitute non-printable characters with readable and displayable values such as [EOF] for End of File (Hex x04) or [LF] for Line Feed (Hex x0A).

CUT

Command Options
CUT CUT <opt> "line" or CMD|CUT <opt>
-H : This help screen
-F nn : Output field nn
-M nn : Output starting at nn
-N nn : Output Ending at nn
-S ch : Change default SPACE separator to 'ch'

CHGRP

Command Options
CHGRP In Progress

CHMOD

Command Options
CHMOD In Progress

CHOWN

Command Options
CHOWN In Progress

CHTYP

Command Options
CHTYP Working

CP

Command Options
CP Working

EDIT

Command Options
EDIT Working

FORMAT

Command Options
FORMAT In Progress

GREP

Command Options
GREP Working

KILL

Command Options
KILL Working

LS

Command Options
LS -A : Print . & ..
-C : Single column listing
-F : Single column, includes full path
-L : long listing with size/date...
-R : Recurse subdirectories

LSDEV

Command Options
LSDEV Working

LSOF

Command Options
LSOF Working

MD5

Command Options
MD5 Working

MEM

Command Options
MEM Working

MKDIR

Command Options
MKDIR Working

MORE

Command Options
MORE Working

NSCUTIL

Command Options
NSCUTIL Working

MV

Command Options
MV Working

PS

Command Options
PS Working

RM

Command Options
RM Working

Network Tools

###ARP

Command
ARP

Dump ARP cache, setup a static ARP entry

DNSINFO

Command
DNSINFO -a option to add host????

dump DNS cache, setup a static DNS entry

HTTPGET

Command Options
HTTPGET <ip|host> [port] -U Url
-F UrlFile

IPCONFIG

Command Options
IPCONFIG -D : Try to get IP address from DHCP
-E : Read ETC files
-S : Set/Reset TCPIP configuration (-E, then -D if required)

NETSTAT

Command
NETSTAT

Display socket status

PING

Command
PING <ip|host>
-1..9 : Ping Count

TELNET

Command
TELNET <ip|host> [port]

DHCPCLNT

Command
DHCPCLNT

HTTPD

Command
HTTPD

TCPIPD

Command
TCPIPD

ARP,IP,ICMP,UDP & TCP ok

TELNETD

Command
TELNETD -d [port]???

Developer Tools

While almost every command and program that comes with A2osX can be considered a developer tool, there are a few that are very specifically created to be used for developer. This section discusses those tools.

ASM

Command
ASM

S-C MASM based multi CPU assembler

MEMDUMP

Command
MEMDUMP

Tool to track memory leak

RPCDUMP

Command
RPCDUMP
Tool based on UDP socket API, renamed from RPCINFO
RPCDUMP <ip|host>