Use this command to add breakpoints in communications and application processors in the system.

Parameters

access (optional)

The access type, in the form of access type-format.

Use the data parameter to set the format on IXP-based cards.

Range:

access type-format

access type—r, w, rw (read, write, read-write)

format— byte, word, dword, any

Default:

For x86-based cards— rw-byte

For IXP-based cards— rw-any

addr (optional)

The memory location in the form of segment–offset.

Range:

segment-offset

segment—h’00–h’ffff

offset—h’00–h’ffff

bc (optional)

The number of data bytes to display.

For IXP-based cards, bc represents the number of bytes of memory. The number of bytes of stack to be displayed is 255 – bc. For example, if bc=128, then 128 bytes of memory and 127 bytes of stack are displayed. If bc=0, then 0 bytes of memory and 255 bytes of stack are displayed. The exception to this rule is that 1 byte of stack is never displayed.

Range:

0 - 255

For x86-based cards, the maximum number of bytes is 96.

For IXP-based cards, the maximum number of bytes is 255.

ca (optional)

Condition “a” in the form of register–condition–integer.

The value register is the CPU internal register.

The value condition is the comparison condition (equal, not equal, greater than, less than, greater than or equal, less than or equal).

The value integer is the value for comparison.

Range:

register-condition-integer

register— sp, bp, ds, ss, es, cs, fl, ax, ah, al, bx, bh, bl, cx, ch, cl, dx, dh, dl, di, si, ip, fs, gs, esi, edi, ebp, esp, eip, efl, eax, ebx, ecx, edx, lr, pc, r1-r15

condition—eq, neq, gt, lt, gte, lte

integer—h’00–h’ffffffff

card (optional)

The card location, in the form of GPLID–Subsystem ID.

Range:

GPLID-Subsystem ID

GPLID—atmhc, deirhc, erthc, glshc, hipr2, ipghc, iplhc, ipsg, ipshc, mcphc, oamhc, pktgen, sccphc, siphc, ss7hc, utility

Subsystem ID— a, b, act, stb, all

The OAMHC GPL can be specified with any of the subsystem IDs.

For all other GPLs, only the all subsystem ID is valid.

cb (optional)

Condition b in the form of register–condition–integer.

The value register is the CPU internal register.

The value condition is the comparison condition (equal, not equal, greater than, less than, greater than or equal, less than or equal).

The value integer is the value for comparison.

Range:

register-condition-integer

register—sp, bp, ds, ss, es, cs, fl, ax, ah, al, bx, bh, bl, cx, ch, cl, dx, dh, dl, di, si, ip, fs, gs, esi, edi, ebp, esp, eip, efl, eax, ebx, ecx, edx, lr, pc, r0-r15

condition—eq, neq, gt, lt, gte, lte

integer—h’00–h’ffffffff

ctx (optional)

The bit-mapped microengine context mask.

Range:

1 - 15

da (optional)

The dump address, in the form of segment–offset.

Range:

segment-offset

segment—h’00–h’ffff

offset—h’00–h’ffff

data (optional)

This parameter instructs a data breakpoint to qualify on a match of the data.

Note:

This parameter is valid only on IXP-based cards.

Range:

value-mask

value—0-0xFFFFFFFF

mask—0-0xFFFFFFFF

Default:

0

dformat (optional)

Memory dump format (byte, doubleword, word).

Range:

byte

dword

word

Default:

byte

dpaddr (optional)

Memory dump address (physical offset).

Range:

h’00–h’ffffffff

dr (optional)

The data register indirect memory dump, in the form register-register-integer.

The register-register value is the CPU internal register.

The integer value is the offset value.

Range:

register-register-integer

register—sp, bp, ss, ds, es, cs, fl, ax, ah, al, bx, bh, bl, cx, ch, cl, dx, dh, dl, di, si, ip, fs, gs, esi, edi, ebp, esp, eip, efl, eax, ebx, ecx, edx

register—sp, bp, ds, ss, es, cs, fl, ax, ah, al, bx, bh, bl, cx, ch, cl, dx, dh, dl, di, si, ip, fs, gs, esi, edi, ebp, esp, eip, efl, eax, ebx, ecx, edx

integer— h’00–h’ffffffff

drarm (optional)

ARM register indirect memory dump.

Range:

ARM register-integer

arm register- r0-r15, sp, lr, pc 

mask- 0-65535

The value ARM register is the CPU internal register.

The value integer is the offset value.

Default:

0

dur (optional)

Breakpoint duration.

Range:

temp

perm

Default:

temp

imt (optional)

IMT address of the card.

Range:

0 - 254

ind (optional)

Indirection count.

Range:

0 - 3

Default:

0

loc (optional)

The card location as stenciled on the shelf of the system.

Range:

1101 - 1108, 1111 - 1112, 1201 - 1208, 1211 - 1218, 1301 - 1308, 1311 - 1318, 2101 - 2108, 2111 - 2118, 2201 - 2208, 2211 - 2218, 2301 - 2308, 2311 - 2318, 3101 - 3108, 3111 - 3118, 3201 - 3208, 3211 - 3218, 3301 - 3308, 3311 - 3318, 4101 - 4108, 4111 - 4118, 4201 - 4208, 4211 - 4218, 4301 - 4308, 4311 - 4318, 5101 - 5108, 5111 - 5118, 5201 - 5208, 5211 - 5218, 5301 - 5308, 5311 - 5318, 6101 - 6108, 6111 - 6118, 1109, 1110, 1209, 1210, 1309, 1310, 2109, 2110, 2209, 2210, 2309, 2310, 3109, 3110, 3209, 3210, 3309, 3310, 4109, 4110, 4209, 4210, 4309, 4310, 5109, 5110, 5209, 5210, 5309, 5310, 6109, 6110, 1113, 1115

paddr (optional)

The physical offset of the memory address.

Range:

h’00–h’ffffffff

proc (optional)

Processor type.

Range:

appl

Application processor

com

Communication processor

Default:

appl

rep (optional)

Repetitions for this breakpoint.

Range:

0 - 255

Default:

0

type (optional)

Breakpoint type in the form of processor type-breakpoint type

Range:

processor type-breakpoint type

processor type—p186, p286, p486, arm, ixp

breakpoint type—code, codehw, codesw, data

Default:

For x86-based cards—p486-code

For IXP-based cards—arm-codesw

ueng (optional)

Microengine number. This parameter is valid only on IXP-based cards.

Note:

If this parameter is not specified for an IPX-based card, then the command is assumed to be intended for the ARM processor in the IXP chip.

Range:

0 - 5

Example

ent-bp:loc=1204:paddr=h’27c3c:type=p486-data:access=rw-word

ent-bp:loc=1109:paddr=h’401000:type=arm-codesw:access=rw-any:ca=r7-eq-0

ent-bp:loc=1209:paddr=h’402000:type=arm-data:access=w-any:data=h’1111-h’ff

ent-bp:loc=1309:paddr=h’403000:type=ixp-codesw:ueng=2:ctx=1

ent-bp:card=hipr2-all:paddr=h’404000:type=arm-codehw:drarm=r3-0:bc=64

ent-bp:loc=1113:addr=h'03a-0001

Dependencies

All of the subsystem values can be specified with the OAMHC GPLID. The other GPLID values can be specified only with the all subsystem value.

Values of 1114, 1116, 1117, and 1118 cannot be specified for the loc parameter.

The loc, imt, or card parameter must be specified.

Only one of the loc, imt, and card parameters can be specified in the command.

The dr parameter and the da parameter cannot be specified together in the command.

The dur=perm parameter and the rep parameter cannot be specified together in the command.

The dur=perm parameter cannot be specified when the value of the processor type portion of the type parameter is p186 or p286.

When the da, dr, or drarm parameter is specified, the dpaddr parameter cannot be specified.

For the type parameter (which is in the form of processor type-breakpoint type), a breakpoint type of data cannot be specified in combination with a processor type of P186, P286, or IXP.

When the paddr parameter and the bc parameter are specified, either the dpaddr or dr parameter must be specified in the command.

The access parameter can be specified only when the type parameter value is p486-data or arm-data.

The bc parameter value cannot be greater than 96 for x86-based cards.

The ind parameter value cannot be greater than 3.

The specified card must be in use.

For 80286 processors, registers for 80386 processors cannot be specified.

For 80286 processors, integer values for registers and conditions must be less than 65535.

The ueng parameter is valid only on IXP-based cards (the value ixp is specified for the processor type portion of the type parameter).

The cts parameter is valid only on IXP-based cards (the value ixp is specified for the processor type portion of the type parameter).

The data parameter is valid only on IXP-based cards.

The data parameter is valid only when the value is data for the breakpoint type portion of the type parameter.

The register values sp, lr, pc, and r0-r15 for the ca or cb parameters are valid only on IXP-based (ARM processor) cards.

The ca and cb parameters cannot be specified when the value ixp is specified for the processor type portion of the type parameter.

The drarm parameter can be specified only on IXP-based cards.

The drarm parameter can be specified only when the value arm is specified for the processor type portion of the type parameter.

The dr parameter cannot be specified for IXP-based cards.

The data and codesw values for the breakpoint type portion of the type parameter cannot be specified when the value ixp is specified for the processor type portion of the type parameter.

The arm and ixp values for the processor type portion of the type parameter are valid only on IXP-based cards.

The value any for the format portion of the access parameter can be specified only on IXP-based cards. The format value must be set to any on IXP-based cards.

When the value ixp is specified for the processor type portion of the type parameter, the ueng and cts parameters must be specified.

The addr parameter can be specified only when the proc=com parameter is specified for DS0 cards with PROM-based COM processors (such as TSMs).

When the ca, cb, and dr parameters are used with 80186 and 80286 processors, the register values ip, fs, gs, esi, edi, ebp, esp, eip, efl, eax, ebx, ecx, and edx cannot be specified. These registers can be used only with 80486 processors. The integer values for these parameters when used with 80186 and 80286 processors must be less than h’ffff (65535).

The data value for the breakpoint type portion of the type parameter cannot be specified with the values p186, p286, and ixp for the processor type portion of the type parameter.

The da parameter cannot be specified for IXP-based cards.

An ARM register value must be specified for an IXP-based card with an ARM processor.

The addr or paddr parameter must be specified in the command. Both parameters cannot be specified in the command.

Notes

The imt parameter allows this command to be entered for a card that has not been configured in the system.

Output

ent-bp:loc=1113:addr=h'03a-0001

    rlghncxa03w 04-08-22 21:14:41 EST EAGLE 33.0.0 
    SDS Response Code 22 from IMT Address H'00f6 - command complete. 

    rlghncxa03w 04-08-22 21:14:41 EST EAGLE 33.0.0 
    SDS Response from IMT Address H'000a - command complete. 
;

ent-bp:loc=6205:paddr=h'03a002

    rlghncxa03w 12-05-22 21:14:41 EST EAGLE 45.0.0
    SDS Response Code 22 from IMT Address H'00fd - command complete. 
;