How to use uCLinux on the PSP (Jackson Mo’s port)

uCLinux - Jackson Mo (screenshot)

Once you’ve booted in the uCLinux, you will notice a red square block in the top right. Press & hold the shoulder buttons on the PSP to expand the box to show a keyboard layout.

L:          Numbers and symbols
R:          Letters and symbols
L + R:   Capital letters and symbols

With the chosen shoulder button held down, use the joystick to move the red cursor to the required letter. The TriangleCircleCrossSquare buttons represent the four characters of the highlight box, in respective location.

Type ‘help‘ for a list of commands.
[ENTER] is Circle pressed without the shoulder buttons being held down.

This will show the following commands…


To escape/pause a process or script. Must actually be in a process before being able to break from it.


Change directory.


Advance within a controlling while, for, foreach or until loop. The opposite of a ‘break’ command.


Sort for evaluate, eval is a function that equates a given sum. A Perl example:

my $one = 1;
my $two = 2;
my $total = 0;
my $example = '$total = $one + $two';
eval $example;
print $total;


Exec is a BOURNE and POSIX shell command that replaces the current shell process with the command specified after exec and does not create a new PID. Running exec <command>, the shell will be replaced by that command.


Allows you to exit from a program, shell or log you out.


The process of transferring data from one computer or program to another – In another sense, the method of backing up portions of important data.


Show built-in commands as a list.


The process of logging in a user with a username and password.


Log into a group.


newgrp [ -| -l ] [ group ] [argument]

– | -l Change the environment to what would be expected if the user actually logged in again as a member of the new group.
group A group name from the group database or a non negative numeric group ID. Specifies the group ID to which the real and effective group IDs will be set. If group is a non-negative numeric string and exists in the group database as a group name, the numeric group ID associated with that group name will be used as the group ID.
argument sh and kshonly. Options and operand of the newgrp command.


To obtain information from a drive so that it can be displayed or processed.


To be able to read data or a directory without making any alterations.


Sets the value of an environment variable.


set [–] [-a] [-e] [-f] [-h] [-k] [-m] [-n] [-p] [-s] [-t] [-u] [-v] [-x] [ -o option ] [ -A name ] [arg]

Do not change any of the flags; useful in setting $1 to -.
-a Mark variables which are modified or created for export.
-e Exit immediately if a command exits with a nonzero exit status.
-f Disable file name generation.
-h Locate and remember function commands as functions are defined (function commands are normally located when the function is executed).
-k All keyword arguments are placed in the environment for a command, not just those that
precede the command name.
-m Background jobs will run in a separate process group and a line will print upon completion. The exit status of background jobs is reported in a completion message. On systems with job control, this flag is turned on automatically for interactive shells.
-n Read commands but do not execute them.
-p Disables processing of the $HOME/.profile file and uses the file /etc/suid_profile instead of the ENV file. This mode is on whenever the effective uid is not equal to the real uid, or when the effective gid is not equal to the real gid. Turning this off causes the effective uid and gid to be set to the real uid and gid.
-s Sort the positional parameters lexicographically.
-t Exit after reading and executing one command.
-u Treat unset variables as an error when substituting.
-v Print shell input lines as they are read.
-x Print commands and their arguments as they are executed.
-o option The following argument can be one of the following option names:

allexport Same as -a.
errexit Same as -e.
bgnice All background jobs are run at a lower priority. This is the default mode. emacs Puts you in an emacs style in-line editor for command entry.
gmacs Puts you in a gmacs style in-line editor
for command entry.
ignoreeof The shell will not exit on end-of-file. The command exit must be used.
keyword Same as -k.
markdirs All directory names resulting from file name generation have a trailing / appended.
monitor Same as -m.
noclobber Prevents redirection > from truncating existing files. Require >| to truncate a file when turned on.
noexec Same as -n.
noglob Same as -f.
nolog Do not save function definitions in history file.
nounset Same as -u.
privileged Same as -p.
verbose Same as -v.
trackball Same as -h.
vi Puts you in insert mode of a vi style in-line editor until you hit escape character 033. This puts you in control mode. A return sends the line.
viraw Each character is processed as it is typed in vi mode.
xtrace Same as -x.
-A name Array assignment. Unset the variable name and assign values sequentially from the list arg. If +A is used, the variable name is not unset first.


Changes the position of replaceable parameters in a batch file.


Used to time a simple command.


times [-p] utility [argument]

-p Write the timing output to standard error in the following format:real %f\nuser %f\nsys %f\n < real seconds>, <user seconds>, <system seconds>
utility The name of the utility that is to be invoked.
argument Any string to be supplied as an argument when invoking utility.


Acts as an interrupt to tell a process to stop and wait for further instructions.


Get or set the file mode creation mask.


umask [-S] [000] [mask]

-S Produce symbolic output.The default output style is unspecified, but will be recognized on a subsequent invocation of umask on the same system as a mask operand to restore the previous file mode creation mask.
000 Any three octal digits used for permissions.


Await process completion.


wait [pid] [jobid]

pid The unsigned decimal integer process ID of a command, for which the utility is to wait for the termination.
jobid A job control job ID that identifies a background process group to be waited for. The job control job ID notation is applicable only for invocations of wait in the current shell execution environment, and only on systems supporting the job control option.