Installer online help
The online help for the installation system is of course quite limited due
to space limitations. However, the help that is available isn't really
enough for new users who are just being exposed to *nix for the first time.
We can't take on the job of *nix education within the installer, but I think
a few k would really be a good investment for new users. I'm willing to
scrounge a few k from other places if need be...
Let's add a new 'help' command (hard linked to man and info) that just does
nano-tiny -T15 -v /help.txt
My proposed help.txt is attached (it looks best when viewed with the above
command). It's around 6500 bytes uncompressed. We might be able to leave out
some of the help lines and trim a few bytes, probably there are some
commands that new users shouldn't be using anyway. I already left out
commands that would seem to be useful or safe only within scripts. OTOH
maybe having a syntax prompt is helpful even for experienced people, for
infrequently-used system setup commands. This file was compiled from the
commands available in the powerpc installer system, probably there are a few
others needed for i386 etc.
The busybox commands do have a one-line response for --help already, but
often times that one line is less than helpful - try cp, mount, and umount
for example. It would make more sense to dispense with those, or collect any
really valuable information together into one place people can quickly
browse thru or search.
--
Chris Tillman
tillman@azstarnet.com
The installer environment provides limited versions of the following
commands. Additional help may be available by typing "<command> --help".
The ^ in nano's help line means "hold the Control key and type ...".
ae see nano-tiny
ar create, modify, and extract from archive files
ash the shell program initiated by Execute a Shell or
Ctrl-Alt-F2
cat list the contents of a directory or file to std output
cd change the working directory; "cd .." moves up a level,
"cd /<path>" full path, "cd <path>" relative path
cfdisk create or modify Linux partitions with i386-style
partition tables
chgrp change the group associated with the file permissions or
directory; "chgrp <grp> <target>"
chmod change permissions associated with a file or directory;
"chmod 0444 <target>"
chown change the ownership of a file or directory;
"chown <new-owner> <target>"
chroot make the root directory something other than / on
the file system; "chroot <root-now> <new-root>"
chvt change tty (similar to Left-Alt Fn); "chvt5" creates
tty5 or brings it to the front
clear clear the terminal screen
cp copy source file or file-list to target file or
directory; "cp <source> <target>"
cut show the result of cutting a file vertically;
"cut -f 1 <this-file>" gives the first column only
date show the system date and time, or set it using
"date <MMDDhhmm[[CC]YY][.ss]>"
dbootstrap the installation program (runs after installer boot)
dd copy file converting formats;
"dd if=<source filename> of=<target location>"
ddisk see fdisk
depmod create a dependency makefile for modprobe
df show free disk space for all mounted partitions
dhclient-2.2.x dhcp client
dmesg show the messages from the most recent system boot
du show disk usage; "du -h --max-depth=3 <directory>"
to list sizes in megabytes up to 3 levels deep
e2fsck check for and correct ext2 filesystem disk errors
echo show a line of text
edit see nano-tiny
eject eject removable disks; "eject --floppy",
"eject --cdrom", "eject /dev/sdb4"
emacs see nano-tiny
env show the environment variables and their values
exit terminate the shell and return to the installer
expr show the result of evaluating an expression
fdisk create or modify i386-style disk partitions
fgrep see grep
find look for files in a directory tree;
"find / -name <filename>", "find /bin -name e*"
free show used and free system memory and swapped memory
fuser show the pids of processes using a file or fs
grep search for a regular expression; -i case insensitive
"grep <regexp> <file or file-list>"
gunzip see gzip
gzip compress/decompress a file in .gz format;
-d decompress, -l list only, -c to std output
halt shut down the computer (only executable by root user)
head show the first several lines of a file or file-list;
"head -n 20 <filename>"
help see man
id show information about a specified user, or the user of
the current process
ifconfig manually configure kernel-resident network interfaces
info see man
insmod dynamically load a kernel module;
"insmod <module-filename>" (filename ends with .o)
kill terminate a specified process;
"kill <pid>" (use ps to identify the pid)
killall terminate all processes executing a given command;
"killall -HUP <command-name>"
klogd log kernel error messages to std error or a file
ksyms show exported kernel symbols (related to loadable
kernel modules)
lilo install i386 bootloader
ln create a hard (or soft) link to an existing file or
directory; "ln -s <target> <link-name>"
logger allow shell command to make entries in the system logs
ls show the contents of a directory;
-l long format, -R recursive, -a show hidden files
lsmod list all loaded kernel modules
mac-fdisk create or modify powerpc-style partitions
man display this mini-manual
md5sum compute or verify the checksum for a file; -c check
mformat format a floppy disk with MS-DOS style formatting
mkdir create a new directory
mke2fs create a new ext2 filesystem; format partition
mkfs.ext2 see mke2fs
mkofboot initialize an Apple_Bootstrap HFS partition and
transfer the configured yaboot bootloader to it
mkswap initialize a swap partition
modprobe high level handling of loadable modules;
-l list, -t type
more present output in pages to allow viewing;
"more <filename>", "ls -l /etc | more"
mount mount a disk partition to a directory;
"mount -t <filesystem type> /dev/hda3 <directory>"
mv move or rename a file or file-list;
"mv <source> <target file or directory>"
nano see nano-tiny
nano-tiny text editor
netstat show the status of the network
nvsetenv set nonvolatile RAM environment variables, use
alone to show current NVRAM state
ofpath show the Open Firmware path corresponding to a
given Linux block device; "ofpath /dev/hda5"
ping request a number of packets from a network host to
test the network; "ping -c 4 www.google.com"
poweroff shut down the computer
ps show the list of processes currently running; "ps -A"
pwd show the current working directory
reboot restart the computer (only executable by root user)
reset clear the terminal screen and reset the terminal
rm permanently remove a file or file-list;
use -i to prompt for confirmation
rmdir remove an empty directory
rmmod remove a dynamically loadable module from the kernel
route show or edit the IP routing table
sed stream editor; "sed -f <script-file> <input-file>"
sh see ash
sort sort, merge, or compare the specified files
sync flush all memory resident changes to disk
tail show the tail end of a file;
"tail <number of lines> <filename>"
tar store and extract files from/to a tar archive file;
"tar -xf <filename.tar>", -c create, -z compress
telnet login to a remote host computer
touch update a file's modification date
tr translate characters from std input to std output
umount unmount a filesystem device from a directory;
"umount /instmnt", "umount /dev/sda"
uname show information about the operating system;
type, hostname, system version, version #, hardware
uniq show the unique lines from a sorted file
(discard duplicate lines)
update-modules generate an automatic update to /etc/modules.conf
uptime show the amount of time the system has been operational
vi see nano-tiny
wc show the character, word and line count of a file or
file list.
which show the path to an executable command
whoami show the login username
yabootconfig configure yaboot (the powerpc bootloader)
ybin save the configured yaboot files; must follow any
change to powerpc boot configuration
zcat perform gunzip to standard output
Reply to: