ent-bp

5.25 ent-bp

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— 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—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—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:

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.

2101 E2101 Cmd Rej: Card location is unequipped

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

2212 E2212 Cmd Rej: Invalid card type for this command

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

2214 E2214 Cmd Rej: Missing parameter - CARD, LOC, or IMT

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

2217 E2217 Cmd Rej: More than one of CARD, LOC, and IMT specified

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

2209 E2209 Cmd Rej: Both DR and DA parameters cannot be entered

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

2696 E2696 Cmd Rej: REP cannot be specified when DUR=PERM

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

2698 E2698 Cmd Rej: DUR=PERM cannot be specified with P186 or P286

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

2695 E2695 Cmd Rej: DPADDR cannot be entered with DR/DRARM/DA

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.

2699 E2699 Cmd Rej: DATA cannot be specified with TYPE = 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.

2703 E2703 Cmd Rej: Missing parameter - DPADDR or DR

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

2700 E2700 Cmd Rej: ACCESS can only be specified with TYPE=P486-DATA or ARM-DATA

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

2219 E2219 Cmd Rej: Specified BC exceeds max allowed (96)

The ind parameter value cannot be greater than 3.

2697 E2697 Cmd Rej: IND cannot be greater than 3

The specified card must be in use.

2101 E2101 Cmd Rej: Card location is unequipped

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

2720 E2720 Cmd Rej: 386/486 register cannot be specified

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

2721 E2721 Cmd Rej: Integer value 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).

4151 E4151 Cmd Rej: UENG parameter is invalid for this card

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

4146 E4146 Cmd Rej: CTX parameter is invalid for this card

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

4148 E4148 Cmd Rej: DATA parameter is invalid for this card

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

4152 E4152 Cmd Rej: Invalid combination of TYPE and DATA parameters

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

4153 E4153 Cmd Rej: CA or CB register value is invalid for this card

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

4150 E4150 Cmd Rej: CA/CB parameters are invalid for this processor

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

4156 E4156 Cmd Rej: DRARM parameter is invalid for this card

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

4154 E4154 Cmd Rej: DRARM parameter is invalid for this processor

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

4155 E4155 Cmd Rej: DR parameter is invalid for this card

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.

4145 E4145 Cmd Rej: TYPE parameter value is invalid for this processor

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

4159 E4159 Cmd Rej: TYPE parameter value is invalid for this card

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.

4160 E4160 Cmd Rej: ACCESS parameter value is invalid for this card

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

4147 E4147 Cmd Rej: Invalid combination of TYPE, UENG, and CTX parameters

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).

4158 E4158 Cmd Rej: ADDR parameter is invalid for this card

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).

N/A N/A

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.

4152 E4152 Cmd Rej: Invalid combination of TYPE and DATA parameters

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

4157 E4157 Cmd Rej: DA parameter is invalid for this card

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

4149 E4149 Cmd Rej: ARM register must be specified

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

2694 E2694 Cmd Rej: Invalid combination of ADDR and PADDR specified

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. 
;

Related Topics