handle_common_option()

Description:

Take the option identified by opt (a single ASCII character) and process it. This function assumes that the global variable optarg points to the argument string for the option.

Valid values for opt and their actions are:

A

Reboot switch. If set, an OS crash will cause the system to reboot. If not set, an OS crash will cause the system to hang.

D

Output channel specification (e.g. kprintf(), stdout, etc.).

f [cpu_freq][,[cycles_freq][,timer_freq]]

Specify CPU frequencies. All frequencies can be followed by H for hertz, K for kilohertz, or M for megahertz (these suffixes aren't case-sensitive). If no suffix is given, the library assumes megahertz if the number is less than 1000; otherwise, it assumes hertz.

If they're specified, cpu_freq, cycles_freq, and timer_freq are used to set the corresponding variables in the startup code:

• cpu_freq — the CPU clock frequency. Also sets the speed field in the cpuinfo section of the system page.
• cycles_freq — the frequency at which the value returned by ClockCycles() increments. Also sets the cycles_per_sec field in the qtime section of the system page.
• timer_freq — the frequency at which the timer chip input runs. Also sets the timer_rate and timer_scale values of the qtime section of the system page.

K

kdebug remote debug protocol channel.

M

Placeholder for processing additional memory blocks. The parsing of additional memory blocks is deferred until init_system_private().

N

Add the hostname specified to the typed name string space under the identifier _CS_HOSTNAME.

R

Used for reserving memory at the bottom of the address space.

r

Used for reserving memory at any address space you specify.

S

Placeholder for processing debug code's -S option.

P

Specify maximum number of CPUs in an SMP system.

j

Add Jtag-related options. Reserves four bytes of memory at the specified location and copies the physical address of the system page to this location so the hardware debugger can retrieve it.

v

Increment the verbosity global flag, debug_flag.

Returns:

>0

Success.

-1

Error