BusinessPhone Communication Platform 7.0
Maintenance Instruction ASB 150 02

## IPU command line interface

### General

The command interface of the IPU has three main advantages.

1. to set and dump configuration parameters from the BMS or telnet interface (which image to boot, alternative MAC address, disk usage, running image, etc.)
2. for trouble shooting IP connections (ping, traceroute, route)
3. to validate downloaded images.

#### Requirements for connection via V.24:

####

baudrate |  | 9600 |
databit |  | 8 |
parity |  | no |
stopbit |  | 1 |

#### Requirement via telnet connection:

TCP port 23

#### Connect to command mode

username: |  | remote |
password: |  | <system password> |

### Commands

#### Command [adjust]

adjust - gracefully adjust real time clock

##### SYNOPSIS

adjust [+/-] <microseconds>

##### DESCRIPTION

The adjust command tells the real time clock (RTC) to incrementally slow or speed up the real time. Every 5 minutes (receiving of a CALENDAR message from CPU) the RTC time will be compared with the time in the CALENDAR message. In case of deviation more than 60 seconds the RTC time will be updated with the time in the CALENDAR message.

##### OPERANDS

The following operand is supported:

microseconds |  | Is the time in microseconds with which the RTC should be adjusted |

##### EXAMPLES

$ adjust 500 |
'adjust' terminated. |
$ |

#### Command [cat]

cat - concatenate and display files

##### SYNOPSIS

cat [<file>...]

##### DESCRIPTION

cat reads each file in sequence and writes it on the standard output.

##### OPERANDS

The following operand is supported:

file |  | A path name of an input file and the name of the input file or only the name of the input file |

##### EXAMPLES

$ cat ipu.ulk |
SF065 |
Licensed for 8 voice channels |
Card-ID: SunDisk SDCFB-8 |
Serial-No: MT300821628 |
Cylinders: 245 |
Heads: 2 |
Sectors: 32 |
'cat' terminated. |
$ |

#### Command [cd]

cd - change working directory

##### SYNOPSIS

cd [ <dir> ]

##### DESCRIPTION

The cd utility will change the working directory of the current shell execution environment. If dir (directory name) specifies a complete path starting with ` / ', ` . ', or ` .. ', dir becomes the new working directory. cd must have execute (search) permission in dir.

##### OPERANDS

The following operand is supported:

dir |  | An absolute or relative pathname of the directory that becomes the new working directory |

##### OUTPUT

An absolute pathname of the new working directory will be written to the standard output as follows:
"Current directory now %s\n", <new directory>

##### EXAMPLES

$ pwd |  |  |  |  |  |  |
/cf0/testdir/dir1/ |  |  |  |  |  |  |
'pwd' terminated. |  |  |  |  |  |  |
$ cd .. |  |  |  |  |  |  |
Current directory now /cf0/testdir/ |  |  |  |
'cd' terminated. |  |  |  |  |  |  |
$ cd /cf0/testdir/dir1 |  |  |  |  |  |  |
Current directory now /cf0/testdir/dir1/ |  |  |  |
'cd' terminated. |  |  |  |  |  |  |
$ |  |  |  |  |  |  |
$ pwd |  |  |  |  |  |  |
/ |  |  |  |  |  |  |
'pwd' terminated. |  |  |  |  |  |  |
$ cd cf0 |  |  |  |  |  |  |
Current directory now /cf0/ |  |  |  |
'cd' terminated. |  |  |  |  |  |  |
$ ls |  |  |  |  |  |  |
IPU.ULK |  | TEST.TXT |  | TEST |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |
$ |  |  |  |  |  |  |

#### Command [cfinfo]

cfinfo - print information about CF disk

##### SYNOPSIS

cfinfo

##### DESCRIPTION

The cfinfo command prints the following information about the CF disk to the standard output:
model number, serial number, revision number and disk size.

##### EXAMPLES

$ cfinfo |
Information about inserted CF disk: |
Model number: SunDisk SDCFB-8 |
Serial number: MT300821628 |
Revision number: vcb 1.34 |
Disk size: 7840 kB |
'cfinfo' terminated. |
$ |

#### Command [checkipu]

checkipu - check the image for validity

##### SYNOPSIS

checkipu <imagefile>

##### DESCRIPTION

The checkipu command checks that the imagefile contains an image which is valid to be used on the IPU board. That means the checksum is correct and the file contains a RYS- (Rysname), LZY- (Lzyname), ROF- (Rofname) and IPU-string (Type).

##### OPERANDS

The following operand is supported:

imagefile |  | Filename of the file containing the image that should be checked |

##### EXAMPLES

Example checking a valid file: |
$ checkipu IPU_R1A.bin |
This file is a valid IPU image. |
'checkipu' terminated. |
$ |
Example checking an invalid file: |
$ checkipu ipu.ulk |
This file is NOT a valid IPU image. |
'checkipu' terminated. |
$ |

#### Command [cp]

cp - copy files

##### SYNOPSIS

cp [<options>] <source_file> <target_file>

##### DESCRIPTION

The cp utility will copy the contents of source_file to the destination path named by target_file. If target_file exists, cp will overwrite its contents, but the mode, owner, and group associated with it are not changed. The last modification time of target_file and the last access time of source_file are set to the time the copy was made. If target_file does not exist, cp creates a new file named target_file that has the same mode as source_file; the owner and group of target_file are those of the owner.

##### OPTIONS

The following options are supported:

-b |  | Isource_file and target_file will be opened in binary mode |

##### OPERANDS

The following operands are supported:

source_file |  | IA path name of a regular file to be copied |
target_file |  | IA pathname of an existing or non-existing file, used for the output |

source_file and target_file can not have the same name

##### EXAMPLES

To copy a file: |  |  |  |  |  |  |  |  |
$ cp ipu.ulk ipu.bak |  |  |  |  |  |
'cp' terminated. |  |  |  |  |  |  |  |  |
$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | TEST.TXT |  | TIPU.BAK |  | TEST |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ |  |  |  |  |  |  |  |  |

#### Command [date]

date - write the date

##### SYNOPSIS

date [[yyyy-]mm-dd]

##### DESCRIPTION

The date command sets the date to the specified date or prints the current date to standard output if no date is specified.

##### OPERANDS

The following operands are supported:

mm |  | Month number |
dd |  | Day number in the month |
yyyy |  | Year number |
All parameters must be numerical.

##### EXAMPLES

$ date |
2000-September-6 |
'date' terminated. |
$ date 2000-09-05 |
'date' terminated. |
$ date |
2000-September-5 |
'date' terminated. |
$ |

#### Command [df]

df - print disk information

##### SYNOPSIS

df

##### DESCRIPTION

The df command prints some disk information to the standard output. The command output has the same format than df -kl under Unix System V.

##### EXAMPLES

$ df |
Filesystem kbytes used avail capacity Mounted on |
ATA_san_disk 7839 2473 5366 31 % /cf0 |
'df' terminated. |
$ |

#### Command [dspinfo]

dspinfo - print dsp information

##### SYNOPSIS

dspinfo <options>

##### DESCRIPTION

The dspinfo command can be used for:

- print information like DSP program version and type of DSM module to the standard output
- read the content of the I2C memory of a DSM module into a file on the Compact Flash disk
- write the content of a file on the Compact Flash disk into the I2C memory of a DSM module

##### OPTIONS

Combinations of different options are not supported

-p |  | print DSP information |
-w module number [-f filename] |  | write I2C memory on DSM module |
|  | use the values 0, 1 and 2 for module number |
|  | if no filename is stated a default filename (DSPI2C.BIN) is used |
|  | the file must exist in the root directory of the Compact Flash disk |
-r module number [-f filename] |  | read I2C memory on DSM module and write to file |
|  | use the values 0, 1 and 2 for module number |
|  | if no filename is stated a default filename (DSPI2C.BIN) is used |
|  | the file will be created in the root directory of the CompactFlash |
|  | disk |

##### EXAMPLES

$ dspinfo -p
DSP module 0:
|  | 2 DSP's equipped. |
|  | module type is: DSM1 |
|  | DSP 0 program version P2AD |
|  | DSP 1 program version P2AD |
DSP module 1:
|  | 2 DSP's equipped. |
|  | module type is: DSM2 |
|  | DSP 2 program version P2AD |
|  | DSP 3 program version P2AD |
DSM module 2 not equipped
'dspinfo' terminated.
$ dspinfo -r 0
default filename is used
'dspinfo' terminated.
$ dspinfo -r 0 -f DSM1.BIN
'dspinfo' terminated.
$ dspinfo -w 1 -f DSM1.BIN
'dspinfo' terminated.

#### Command [dumpipu]

dumpipu - dumps identification information

##### SYNOPSIS

dumpipu <imagefile>

##### DESCRIPTION

The dumpipu command prints information of the specified imagefile to the standard output.

##### OPERANDS

The following operand is supported:

imagefile |  | Filename of the file containing the image from which the information should be printed |

##### EXAMPLES

$ dumpipu ipu_r1a.bin |
RYS: RYS 102 541/1 R1A |
LZY: LZYBS 20313/1 |
ROF: ROF 157 5133/1.IPU |
Build initiator: |
Build init date: |
Image Type: TYPE IPU/9 |
Image Size: SIZE 4096 |
Image Index: INDEX 1 |
Image Checksum: 5152 |
Production user: sea-eb-buildmast |
Production date: Fri Aug 11 13:58:06 2000 |
Production machine: NE0008C7994E12 |
'dumpipu' terminated. |
$ |

#### Command [echo]

echo - echo arguments

##### SYNOPSIS

echo [<options>] [<string> ...]

##### DESCRIPTION

The echo command echoes its arguments on the standard output followed by a newline character. Without arguments, only the newline character is output.

##### OPTIONS

The following options are supported for cp:

-n |  | Inhibits the trialing newline character |

##### OPERANDS

The following operand is supported:

string |  | A string to be written to standard output |

##### EXAMPLES

$ echo test |
test |
'echo' terminated. |
$ |

#### Command [errno]

errno - print description of errno number

##### SYNOPSIS

errno [<number> ...]

##### DESCRIPTION

The errno command prints the specified error numbers (according to the errno.h header) and their corresponding explanations, one on each line. With no arguments, errno prints a list of all errno codes and their explanations.

##### OPERANDS

The following operand is supported:

number |  | number of errnos which description should be printed |

##### EXAMPLES

$ errno 3 4 |
3 : No such process. |
4 : Interrupted function call. |
'errno' terminated. |

#### Command [exit]

exit - exit shell

##### SYNOPSIS

exit

##### DESCRIPTION

The exit command exits (quits) the shell session.

##### EXAMPLES

$ exit |
'exit' terminated. |
Connection to host lost. |

#### Command [flash]

flash - maintenance of onboard boot flash

##### SYNOPSIS

flash <options>

##### DESCRIPTION

The flash command can be used for:

- print information of the onboard flash to the standard output
- write the content of the onboard flash into a file on the Compact Flash
- write the content of a file on the Compact Flash into the onboard flash

If the upgrade of the flash image fails, the ipu remains working until a reset of the board is done. In this case the IPU will not start any more. Until the reset you can try as often as you want to upgrade flash image. Check the file for validity (with checkipu) before you flash it, because of flashing a non IPU image is possible, but makes no sense.

##### OPTIONS

Combinations of different options are not supported

-a |  | print flash information |
-d <file name> |  | Dump flash image to file. file name defines the file into which the image will be dumped |
-u <file name> |  | Upgrade flash image from file. file name defines the file which contains the image that will be used for the upgrade |

##### EXAMPLES

$ flash -a |
RYS: RYS 102 539/1-2 R1A |
LZY: LZYBS 20313/1 |
ROF: ROF 157 5133/1.IPU |
Build initiator: seabueg |
Build init date: 11.08.2000/11:30:00 |
Image Type: TYPE IPU/9 |
Image Size: SIZE 4096 |
Image Index: INDEX 1 |
Image Checksum: 4a2f |
Production user: seabueg |
Production date: Fri Aug 11 11:52:49 2000 |
Production machine: NE00508B674A47 |
'flash' terminated. |
$ |

#### Command [help]

help - print syntax and description of commands

##### SYNOPSIS

help [<operand> ...]

##### DESCRIPTION

The help command prints the syntax and a short explanation for each specified command. '?' is an alias for help. Also commands added by the user to shell is supported, as the registration of a command includes the specification of the syntax and explanation strings.

##### OPERANDS

Any command keyword can be used.

##### EXAMPLES

$ help ls pwd |  |  |
ls [-l] [directory] |  | list directory |
pwd |  | print working directory |
'help' terminated. |  |  |
$ |  |  |

#### Command [i2cconfig]

i2cconfig - set i2c configuration

##### SYNOPSIS

i2cconfig <options>

##### DESCRIPTION

The i2cconfig command can be used to print I2C-memory information to the standard output and to write to the I2C-memory.

##### OPTIONS

Any combination of the options is allowed.

##### Print help content:

$ i2cconfig -h |  |  |  |  |  |  |
-a |  | print out all values |  |  |  |  |
-m <MAC> |  | set mac address. MAC is the address which the mac address should be set to. The -m option an alternative MAC address can be defined. If an alternative MAC address is set, the original MAC address is shown in parenthesis if the command is used with the -a option. The alternative MAC address is deleted by setting it to 00:00:00:00:00:00 or FF:FF:FF:FF:FF:FF. If the alternative MAC address is defined, the system uses it instead of the original MAC address. The original MAC address can not be changed.
-i <IP> |  | set fixed IP address |  |  |  |  |
-g <gateway> |  | set default gateway |  |  |  |  |
-n <netmask> |  | set the subnet mask |  |  |  |  |
-b <Boot> |  | set the boot type. |  |  |  |  |
|  | Possible values for Boot are
|  |  |  | BOOTP |  | Bootstrap protocol will be used |
|  |  |  | DHCP |  | Dynamic Host Configuration Protocol will be used |
|  |  |  | fixed |  | a fixed IP address which can be entered with the ‑i option will be used |
-v <version> |  | set the IP version (4 for IPv4 or 6 for IPv6)
-t <type> |  | set the board type |  |  |  |  |
-s <serial> |  | set the serial number |  |  |  |  |
-p <date> |  | set the production date |  |  |  |  |
-f <ROF> |  | set the rof number |  |  |  |  |
-r <revision> |  | set the revision string |  |  |  |  |
-d <precedence> |  | set precedence of data (0..7)
-o <TOS> |  | type of service (normal, cost, reliability, throughput, delay)
-c <DiffServ> |  | Differentiated Services parameter according to RFC2474 NOTE: DiffServ will overwrite the precedence and TOS parameter settings entered with -d or -o option. The same octet is used in different specifications. Enter value in binary format: e.g. 00110100 (default = 00000000)
-k <Keep> |  | set keep alive time in seconds (64 - 999)

##### Print all values:

$ i2cconfig -a |  |  |
Version: |  | 8001 |
MAC-address: 00:80:37:0F:55:26
Boot type: |  | BOOTP |
IP version: |  | V4 |
IP Address: |  | 194.48.233.229 |
Gateway: |  | 194.48.233.200 |
Subnetmask: |  | 255.255.255.0 |
Boardtype: |  | IPU |
Serial number: |  | TB90403320 |
Prod.date: |  | 0114 |
ROF number: |  | ROF1575133/1 |
Revision: |  | R1C/A |
Precedence: |  | 5 |
TOS: |  | normal |
DiffServ: |  | 10111000 |
Keep alive: |  | 64 |
'i2cconfig' terminated. |  |  |

Diffserv is a re-interpretation of the ToS (Type of service) field used to give priority to the IP datagrams. The Diffserv octet consists of the field DSCP (Differentiated Services Codepoint, bits 0 to 5) and Reserved (bits 6 and 7). The reserved field must be set to 0. The DSCP field consists of the fields Traffic class (bits 0, 1, 2) and Drop precedence (bits 3, 4, 5). Bit 0 is the leftmost bit.

TrafficClass, this data identifier can be set to eight different values:

- 7 (Network Control bit 0-2: 111) Should not be used.
- 6 (Internet Control bit 0-2: 110) Should not be used.
- 5 (Expedited Forwarding bit 0-2: 101)
- 4 (Class D bit 0-2: 100)
- 3 (Class C bit 0-2: 011)
- 2 (Class B bit 0-2: 010)
- 1 (Class A bit 0-2: 001)
- 0 (Best Effort bit 0-2: 000)

DropPrecedence, this data identifier can be set to three different values:

3 (High Drop Precedence bit 3-5: 110)

2 (Medium Drop Precedence bit 3-5: 100)

1 (Low Drop Precedence bit 3-5: 010)

Not used:

bit 6-7 are currently reserved for future use and should be set to 0

####

$ i2cconfig -m 00:00:00:00:00:00 |  |  |
New MAC-address: 00:80:37:0F:55:26
'i2cconfig' terminated. |  |  |
$ i2cconfig -a |  |  |
MAC-address: 00:80:37:0F:55:26 |  |  |
Boot type: |  | BOOTP |
IP version: |  | V4 |
IP Address: |  | 194.48.233.229 |
Gateway: |  | 194.48.233.200 |
Subnetmask: |  | 255.255.255.0 |
Boardtype: |  |  |
Serial number: |  |  |
Prod.date: |  |  |
ROF number: |  |  |
Revision: |  |  |
Precedence: |  | 0 |
TOS: |  | normal |
Keep alive: |  | 64 |
'i2cconfig' terminated. |  |  |

Command [ifconfig]

ifconfig - configure network interface

##### SYNOPSIS

ifconfig -a | interface [options]

##### DESCRIPTION

The ifconfig command configures the network interface. Do not use the sub commands up and down at the this stage.

##### OPTIONS

-a |  | print out all values |

##### OPERANDS

interface <options> |  | interface name
|  | The following options are available:
|  |  |  | up |
|  |  |  | down ] |
|  |  |  | address <local_addr> |
|  |  |  | dstaddr <peer_addr> |
|  |  |  | netmask <mask> |
|  |  |  | broadcast <broad_addr> |
|  |  |  | alias |

##### EXAMPLES

$ ifconfig -a |
lo0: <UP,BROADCAST,LOOPBACK,RUNNING> mtu 1500 |
inet 127.0.0.1 netmask 255.0.0.0 broadcast 127.255.255.255 |
le1: <UP,BROADCAST,RUNNING> mtu 1500 |
inet 194.48.233.229 netmask 255.255.255.0 broadcast 194.48.233.255 |
'ifconfig' terminated. |
$ |

#### Command [iotrace]

iotrace - configures and saves IO-interface trace

##### SYNOPSIS

iotrace <options>

##### DESCRIPTION

The iotrace command configures the io-interface trace.

##### OPTIONS

-a |  | print IO statistics |
-i |  | print connection info |
-c |  | clear log information |
-g [Ind] |  | starts log for Individual Ind [0..3] |
-s [Ind] |  | stops log Individual [0..3] |
-w |  | stop log and write log information on Flash disk |

##### EXAMPLES

$ iotrace -i |  |
IO - TRACE 00001002/R1A |  |
started:----- stopped:----- Logged:0000 lines |  |
Ind0 Port: 0 Protocol:NOT CONNECTED | TRACE --OFF- |
Ind1 Port:6001 Protocol:WILMER | TRACE --OFF- |
|  | connected to 159.107.114.165:2252 at:Thu Jan 21 00:01:35 2001
Ind2 Port: 0 Protocol:NOT CONNECTED | TRACE --OFF- |
Ind3 Port: 0 Protocol:NOT CONNECTED | TRACE --OFF- |

#### Command [listenv]

listenv - list environment variables [for process]

##### SYNOPSIS

listenv <pid>

##### DESCRIPTION

List the environment variable for the shell process if the command is used without operand, or the environment variable for the process with the given pid.

##### OPERANDS

pid |  | process identifier, to get a list of all pids use the ps command (see description of ps command). |

##### EXAMPLES

$ listenv 0x018b0078 |
Environment variables for process ose_shell (0x18b0078): |
FD0=0x6520076,0x7,1,80,0x0 |
FD1=0x6520076,0x8,1,80,0x0 |
FD2=0x6520076,0x9,1,80,0x0 |
PARENT=0x454008a |
UMASK=0 |
CWD=/ |
ose_heap=@@@A@@@@ |
OSE_ERRNO=........ |
efs_flib_vars=@...@@@@ |
efs_shellvars=@.<8@@@@ |
'listenv' terminated. |

#### Command [ls]

ls - list contents of directory

##### SYNOPSIS

ls [ <options> ] [ <directory> ]

##### DESCRIPTION

ls lists the contents of the directory. There are three major listing formats. The default format for output directed to a terminal is multi-column with entries sorted down the columns.

The mode printed under the -l option consists of ten characters. The first character may be one of the following:

d |  | the entry is a directory; |
- |  | the entry is an ordinary file; |

The next 9 characters are interpreted as three sets of three bits each. The first set refers to the owner's permissions; the next to permissions of others in the user-group of the file; and the last to all others.
On the IPU board the permissions for all three groups are equal.
Within each set, the three characters indicate permission to read, to write, and to execute the file as a program, respectively.
On the IPU board only the combination r and rw are used for files.
For a directory, ``execute'' permission is interpreted to mean permission to search the directory for a specified file.
The permissions are indicated as follows:

|  | r |  | the file is readable |
|  | w |  | the file is writable |
|  | x |  | the file is executable |

##### OPTIONS

The following options are supported:

|  | -l |  | List in long format, owner, group, size in bytes, and time for each file. |

##### EXAMPLES

$ ls -l |  |  |  |  |  |  |  |  |  |  |
-rw-rw-rw- |  | 1 root |  | root |  | 161 |  |  |  | 07/22/2000 IPU.ULK |
-rw-rw-rw- |  | 1 root |  | root |  | 512 |  |  |  | 09/18/2000 BPBTU_TM.TXT |
-rw-rw-rw- |  | 1 root |  | root |  | 6353 |  |  |  | 09/18/2000 PCMTRACE.BIN |
-rw-rw-rw- |  | 1 root |  | root |  | 15942 |  |  |  | 09/18/2000 DSPTRACE.BIN |
-rw-rw-rw- |  | 1 root |  | root |  | 2105028 |  |  |  | 08/11/2000 IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |  |
$ |  |  |  |  |  |  |  |  |  |  |

#### Command [mkdir]

mkdir - make directory

##### SYNOPSIS

mkdir <dir>

##### DESCRIPTION

The mkdir command creates the named directory. Creation of a directory requires write permission in the parent directory.

##### OPERANDS

The following operand is supported:

dir |  | A path name of a directory to be created. |

##### EXAMPLES

$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | TEST.TXT |  | IPU.BAK |  | IPU_R1A.BIN |  |  |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ mkdir testdir |  |  |  |  |  |  |  |  |
'mkdir' terminated. |  |  |  |  |  |
$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | TEST.TXT |  | IPU.BAK |  | TESTDIR |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ |  |  |  |  |  |  |  |  |

#### Command [mv]

mv - rename file

##### SYNOPSIS

mv <source_file> <target_file>

##### DESCRIPTION

The mv utility renames the file named by the source_file operand to the name specified by the target_file. source_file and target_file may not have the same name. If target_file does not exist, mv creates a file named target_file. If target_file exists, its contents will be overwritten.

##### OPERANDS

The following operands are supported:

|  | source_file |  | A path name of a file to be renamed. |
|  | target_file |  | A new path name for the file being renamed. |

##### EXAMPLES

$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | TEST.TXT |  | IPU.BAK |  | TESTDIR |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ mv test.txt test1.txt |  |  |  |  |  |
'mv' terminated. |  |  |  |  |  |
$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | TEST1.TXT |  | IPU.BAK |  | TESTDIR |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ |  |  |  |  |  |  |  |  |

#### Command [ping]

ping - send ICMP ECHO_REQUEST packets to network hosts

##### SYNOPSIS

ping [ <options> ] <host>

##### DESCRIPTION

The utility ping utilizes the ICMP protocol's ECHO_REQUEST datagram to elicit an ICMP ECHO_RESPONSE from the specified host or network gateway. If host responds, ping will print host is alive on the standard output and exit. Otherwise, after time-out seconds, it will write host unreachable

##### OPTIONS

The following options are supported:
-a |  | use OSE asynchronous interface. Default = no |
-b |  | bind the ICMP socket. Default = no |
-c |  | connect the ICMP socket. Default = no |
-i <ifname> |  | specify outgoing interface to use for multicast packets. |
-I <##> |  | interval (in ms) between each ping. Default = 50 |
-L |  | turn off loopback of multicast packets. |
-n <##> |  | number of pings. Default = 1 |
-s <##> |  | ping request packet size [0-1464]. Default = 56 |
-t <##> |  | set time to live for unicast and multicast. |
-T <##> |  | ping time-out in milliseconds. Default = 10,000 |

##### OPERANDS

host |  | The network host (only numerical) |

##### EXAMPLES

$ ping 194.48.233.229 |
194.48.233.229 is alive |
'ping' terminated. |
$ |
$ ping -s 200 -n 5 194.48.233.229 |
208 bytes from 194.48.233.229: icmp_seq=0 ttl=64 |
208 bytes from 194.48.233.229: icmp_seq=1 ttl=64 |
208 bytes from 194.48.233.229: icmp_seq=2 ttl=64 |
208 bytes from 194.48.233.229: icmp_seq=3 ttl=64 |
208 bytes from 194.48.233.229: icmp_seq=4 ttl=64 |
5 packets transmitted, 5 packets received |
'ping' terminated. |

#### Command [ps]

ps - report process status

##### SYNOPSIS

ps [<options>] [<pid>/<bid>] ...

##### DESCRIPTION

The ps command lists the specified process or all processes belonging to the specified block. Processes and blocks can be specified by name. With no parameters all processes are listed. If a name is given which matches multiple process or block names, one (unspecified which) will be chosen.

##### OPTIONS

The following options are supported:

-w |  | Wide listing. |
-b |  | Allows a block id to be given. |

##### OPERANDS

pid |  | process identifier |
bid |  | block identifier |

##### EXAMPLES

$ ps 0x0001003c |  |  |  |
|  | pid name |  | typ pri block |  | own status |
0001003c DspDriver | pri 4 main |  | 0 rcv |
'ps' terminated. |  |  |  |
$ |  |  |  |  |  |  |

#### Command [pwd]

pwd - print working directory

##### SYNOPSIS

pwd

##### DESCRIPTION

pwd writes an absolute path name of the current working directory to standard output.

##### EXAMPLE

$ pwd |
/cf0/ |
'pwd' terminated. |
$ |

#### Command [reboot]

reboot - reboots the ipu

##### SYNOPSIS

reboot [ <options> ]

##### DESCRIPTION

reboot restarts the ipu.

##### OPTIONS

u |  | dismount file system before reboot |
-i |  | reboot immediately |

##### EXAMPLES

$ reboot -i |
The system is going down immediately ! |
$ reboot -u |
Unmount successful, system is going down ! |

#### Command [rm]

rm - remove file

##### SYNOPSIS

rm <filename>

##### DESCRIPTION

The rm utility removes the file specified by the filename argument.

##### OPERANDS

The following operands are supported:

filename |  | A path name of a file to be removed. |

##### EXAMPLES

$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | TEST1.TXT |  | IPU.BAK |  | TESTDIR |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ rm test1.txt |  |  |  |  |  |  |  |  |
'rm' terminated. |  |  |  |  |  |  |  |  |
$ ls |  |  |  |  |  |  |  |  |
IPU.ULK |  | IPU.BAK |  | TESTDIR |  | IPU_R1A.BIN |  |  |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ |  |  |  |  |  |  |  |  |

#### Command [rmdir]

rmdir - remove directory entries

##### SYNOPSIS

rmdir <dirname>

##### DESCRIPTION

The rm utility removes the directory entry specified by the dirname argument. The directory to be removed must be empty.

##### OPERANDS

The following operands are supported:

dirname |  | name of the directory that has to be removed |

##### EXAMPLES

$ ls |  |  |  |  |  |  |
IPU.ULK |  | IPU.BAK |  | TESTDIR |  | IPU_R1A.BIN |
'ls' terminated. |  |  |  |
$ rmdir testdir |  |  |  |  |  |  |
'rmdir' terminated. |  |  |  |
$ ls |  |  |  |  |  |  |
IPU.ULK |  | IPU.BAK |  | IPU_R1A.BIN |  |  |
'ls' terminated. |  |  |  |
$ |  |  |  |  |  |  |

#### Command [route]

route - manually manipulate the routing tables

##### SYNOPSIS

route < options > [ dest mask gateway ]

##### DESCRIPTION

This command should only be used by IP experts.

route manually manipulates the network routing tables.

The network routing tables are only valid until the next restart.

The command behaves similar to UNIX

##### OPTIONS

add |  | Add a route. |
delete |  | Delete a specific route. |
print |  | Lookup and display the route for a destination. |

##### EXAMPLES

$ route print |  |  |  |  |  |  |  |  |
Routing table |  |  |  |  |  |  |  |  |
Destination |  | Gateway |  | Genmask |  | Metric |  | Interface |
0.0.0.0 |  | 194.48.233.200 |  | 255.255.255.255 |  | 1 |  | 1 |
0.0.0.0 |  | 0 |  | 255.255.255.255 |  | 1 |  | 0 |
127.0.0.1 |  | 0 |  | 255.255.255.255 |  | 1 |  | 0 |
194.48.233.0 |  | 1 |  | 255.255.255.0 |  | 10 |  | 1 |
Total of 4 routes. |  |  |  |  |  |  |  |  |
'route' terminated. |  |  |  |  |  |  |  |  |
$ |  |  |  |  |  |  |  |  |

#### Command [rtlookup]

rtlookup - look up a route

##### SYNOPSIS

rtlookup <destination>

##### DESCRIPTION

Look up a route for the used route entry.

##### OPERANDS

destination |  | IP address of destination |

##### EXAMPLES

$ rtlookup |  | 194.48.233.192 |  |  |  |  |
Found Route: |  |  |  |  |  |  |
Destination |  | Gateway |  | Genmask |  | Metric |
194.48.233.0 |  | 0.0.0.1 |  | 255.255.255.0 |  | 10 |
'rtlookup' terminated. |  |  |  |
$ |  |  |  |  |  |  |

#### Command [set]

set - set a shell variable

##### SYNOPSIS

set [ <variable> [ <value> ] ]

##### DESCRIPTION

The set command associates the specified shell variable with the value. If no value is given the null string is used. If no arguments are specified at all, set prints all shell variables and their corresponding values to standard output. See also the unset command. Note: shell variables are only internal in shell and have nothing to do with OSE environment variables.

The shell variables are currently not used.

##### OPERANDS

variable |
value |

##### EXAMPLES

$ set abc 55
'set' terminated.
$ set |  |  |
abc |  | 55 |
'set' terminated.

#### Command [setconf]

setconf - set or delete configuration value

##### SYNOPSIS

setconf <name> [ <value> ]

##### DESCRIPTION

Set or delete configuration value. All configuration settings are stored in a text file /cf0/etc/config.txt. The configuration can be read by showing the file with cat.

Note: available with boot image RYS 102 539/1 R1B or higher

##### OPERANDS

name |  | Currently only one configuration value can be set (appimage). With the value the image for |
|  | the next boot can be set. |
value |  | Please specify the full path of the image. |
|  | If the image, specified in “config.txt”, cannot be found or it is not valid for |
|  | the IPU, the image with the latest date will be used. |
|  | When no value is stated in the command line, the current entry in the “config.txt” |
|  | will be deleted |

##### EXAMPLES

Example how to set the “appimage” entry within the config.txt file:

$ setconf appimage /cf0/image/ipu_r3a.bin |  |  |  |
'setconf' terminated. |  |  |  |  |  |  |  |  |
$ pwd |  |  |  |  |  |  |  |  |
/cf0/etc/ |  |  |  |  |  |  |  |  |
'pwd' terminated. |  |  |  |  |  |  |  |  |
$ ls -l |  |  |  |  |  |  |  |  |
-rw-rw-rw- |  | 1 root |  | root |  | 26 |  | 10/03/2000 CONFIG.TXT |
'ls' terminated. |  |  |  |  |  |  |  |  |
$ cat config.txt |  |  |  |  |  |  |  |  |
appimage=/cf0/image/ipu_r3a.bin |  |  |  |
'cat' terminated. |  |  |  |  |  |  |  |  |

Example how to delete the “appimage” entry within the config.txt file:

$ setconf appimage |
'setconf' terminated. |
$ cat config.txt |
'cat' terminated. |

#### Command [setenv]

setenv - set an environment variable

##### SYNOPSIS

setenv <variablename> [<value>]

##### DESCRIPTION

The environment variables can be changed with this command, but it is recommended to do not change this variables.

The setenv command associates the specified environment variable (for the shell process) with the value. If no value is given the null string is used. With no parameters, the environment variables for the shell process are listed. Environment variables are inherited by commands executed from shell.

##### OPERANDS

variablename |  | Is the name of the environment variable that should be set. |
value |  | Is the value that should be assigned the environment variable specified with |
|  | variablename |

##### EXAMPLES

$ pwd |
/cf0 |
'pwd' terminated. |
$ setenv CWD /cf0/testdir |
'setenv' terminated. |
$ pwd |
/cf0/testdir |
'pwd' terminated. |
$ |

#### Command [sysinfo]

sysinfo - print system information

##### SYNOPSIS

sysinfo

##### DESCRIPTION

The sysinfo command print system information about the currently running image to the standard output.

##### OPTIONS

none

##### OPERANDS

none

##### EXAMPLES

$ sysinfo |  |  |
RYS: |  | RYS 102 541/1 R1A |
LZY: |  | LZYBS 20313/1 |
ROF: |  | ROF 157 5133/1.IPU |
Build initiator: |  |  |
Build init date: |  |  |
Image Type: |  | TYPE IPU/9 |
Image Size: |  | SIZE 4096 |
Image Index: |  | INDEX 1 |
Image Checksum: |  | 5152 |
Production user: |  | sea-eb-buildmast |
Production date: |  | Fri Aug 11 13:58:06 2000 |
Production machine: |  | NE0008C7994E12 |
'sysinfo' terminated. |  |  |
$ |  |  |

#### Command [time]

time - print or set time

##### SYNOPSIS

time [hh:mm[:ss]]

##### DESCRIPTION

The time command sets the time to the specified time or prints the current time to standard output if no time specified.

##### OPERANDS

hh |  | hours |
mm |  | minutes |
ss |  | seconds |

##### EXAMPLES

$ time |
10:33:49.77 |
'time' terminated. |
$ time 11:33:00 |
'time' terminated. |
$ time |
11:33:02.84 |
'time' terminated. |
$ |

#### Command [traceroute]

traceroute - print hop-by-hop path to destination.

##### SYNOPSIS

traceroute [<options>] <destination>

##### DESCRIPTION

Find the path to a specified destination.

##### OPTIONS

-n |  | print addresses numerically only |
-m <hops> |  | set the max number of hops (default 30) |
-l <length> |  | set the UDP probe length (default 40 bytes) |
-p <port> |  | set the UDP port number used for probes (default 33440) |
-q <probes> |  | set the number of probes per hop distance (default 3) |
-w <time> |  | set the time to wait for a response (default 3 sec.) |

##### OPERANDS

destination |  | destination IP address |

##### EXAMPLES

$ traceroute 193.186.203.86 |
traceroute to 193.186.203.86 (193.186.203.86), 30 hops max, 40 bytes packets |
1: 194.48.233.200 1325 us 1299 us 1361 us |
2: 193.186.203.86 1119 us 1066 us 1153 us |
'traceroute' terminated. |
$ |

#### Command [unset]

unset - unset (remove) shell variables

##### SYNOPSIS

unset <variable> ...

##### DESCRIPTION

The unset command removes the specified shell variables.

##### OPERANDS

variable |  | name of the shell variable that should be unset |

##### EXAMPLES

$ set abc 55
'set' terminated.
$ set |  |  |
abc |  | 55 |
'set' terminated.
$ unset abc
'unset' terminated.
$ set |  |  |
'set' terminated.
$ |  |  |

#### Command [ver]

ver - print version of kernel, SHELL and EFS

##### SYNOPSIS

ver

##### DESCRIPTION

The ver command prints the version of the OSE kernel and SHELL to standard output.

##### EXAMPLES

$ ver |
OSE Delta PowerPC krn-8xx/R2.1.2 |
OSE Shell R1.0.2 |
OSE EFS R3.0.8 |
'ver' terminated. |
$ |

#### Command [who]

who - list who is logged on

##### SYNOPSIS

who

##### DESCRIPTION

The who command lists users currently logged on (registered with the shell daemon process) to standard output. It prints the user name, user identity (uid), the shell process identity (pid) and terminal name of users logged on to the system.

##### OPTIONS

none

##### EXAMPLES

$ who |  |  |  |  |
pid |  | uid user |  | terminal |
00070072 0 remote | /telnet_194.48.233.12:1126 |
'who' terminated. |  |
$ |  |  |  |  |

Revision: T © Ericsson Enterprise 2005