Contents
Bulk Content Downloader (BCDL) Commands on the Cisco IOS XR Software
This module describes the show commands that you can use to see the status of the Bulk Content Downloader (BCDL) process. The BCDL provides the Cisco IOS XR software with high-performance downloading capabilities. This capability is used by the following internal applications:
IPv4 and IPv6 unicast routing protocols—To provide the ability to download forwarding information from the router Global Routing Information Base (GRIB) to the line cards.
IPv4 and IPv6 multicast routing protocols—To download the Multicast Routing Information Base (MRIB) entries to consumers managing the Multicast Forwarding Information Base (MFIB) on the various line cards and distributed route processors (DRPs).
MPLS—To download the Label Forwarding Information Base (LFIB) entries to the line card.
LPTS—To maintain the Internal Forwarding Information Base (IFIB) table on all nodes that do IP forwarding to and from the DRPs.
Fabric Management—To update memberships for individual fabric group IDs (FGIDs) to selected portions of the fabric hardware.
CDS—Context Distribution Service.
There is no configuration necessary for the BCDL.
show bcdl
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The following example shows sample output from the show bcdl command:
RP/0/RP0/CPU0:router# show bcdl ipv4_rib Sun May 31 06:57:32.153 PST grp ipv4_rib, gid 2051, sg cnt 1, agent jid 111, node 0/RP0/CPU0, pulse 343, new mbr 0 sg lwg fd csmr hdlr-act dnld-act susp wait-lck seq pulse-tot pulse-out 0 2053 15 6 no no no 0 386 338 0describes the significant fields shown in the display.
Table 1 show bcdl Field Descriptions Field
Description
group
Type of download and the Group Services Protocol (GSP) group name.
gid
Heavyweight group (HWG) in the GSP. This is the group that a consumer initially joins. It is used by the BCDL agent to send control updates.
sg count
Number of subgroups for this particular download type.
agent jid
Job identifier of the BCDL agent. The JID is numerical identifier for a particular process and remains the same across process restarts.
node
Node, expressed in the rack/slot/module notation, in which the agent is running.
pulse
Pulse code used by the producer to pulse the BCDL agent.
new mbr
Number of new consumers that have not yet been assigned a subgroup.
sg
Subgroups number.
lwg
Lightweight group in GSP. This is a type of child group of the HWG. The BCDL agent tells the consumers to join this group to receive data.
fd
The connection handle between the producer and the BCDL agent.
csmr
Number of consumers.
hdlr-act
Specifies if there is a download in progress.
dnld-act
Indicates whether the convergence flag has been sent or not.
susp
Indicates whether the download is suspended due to the queue filling up.
wait-lck
If nonzero, some thread is waiting for other thread to take control of this subgroup.
seq
Sequence number of the last message sent on this subgroup.
pulse-tot
Total number of pulses sent by the producer to the BCDL agent.
pulse-out
Total number of outstanding pulses that have not yet been processed by the BCDL agent.
show bcdl consumers
To display Bulk Content Downloader (BCDL) consumer information, use the show bcdl consumers command in EXEC mode.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The following example shows sample output using the show bcdl consumers command:
RP/0/RP0/CPU0:router# show bcdl consumers ipv4_rib Sun May 31 06:18:11.556 PST group ipv4_rib, gsp gid 2051, 6 consumers, agent jid 111, node 0/RP0/CPU0 (expected 6 consumers to reply, received 6 replies) pid node asg csg lwg sus messages bytes errs name 467088 0/RP0/CPU0 0 0 2053 N 386 175152 0 fib_mgr 303249 0/RP1/CPU0 0 0 2053 N 255 73844 0 fib_mgr 94295 0/1/CPU0 0 0 2053 N 379 174612 0 fib_mgr 94295 0/6/CPU0 0 0 2053 N 379 174612 0 fib_mgr 127074 0/4/CPU1 0 0 2053 N 387 175180 0 fib_mgr 118884 0/4/CPU0 0 0 2053 N 387 175180 0 fib_mgr
This table describes the significant fields shown in the display that are not described in Table 1.
Table 2 show bcdl consumers Field DescriptionsField
Description
PID
Process identifier.
node
Consumer node, expressed in the rack/slot/module notation.
asg
Subgroup to which the BCDL agent thinks this consumer belongs.
csg
Subgroup to which the consumer thinks it belongs.
messages
Number of messages processed by this particular consumer.
bytes
Bytes processed by this particular consumer.
errors
Errors encountered by the consumer. This field indicates the number of times the connection was reset.
name
Name of the consumer process.
show bcdl queues
To display the Bulk Content Downloader (BCDL) queue information, use the show bcdl queues command in EXEC mode.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The following example shows sample output from the show bcdl queues command:
RP/0/RP0/CPU0:router# show bcdl queues ipv4_rib Sun May 31 07:13:19.777 PST group ipv4_rib, gsp gid 2051, 6 consumers, agent jid 111, node 0/RP0/CPU0 (expected 6 consumers to reply, received 6 replies) pid node asg csg lwg sus msgs_in_q bytes_in_q errs name 467088 0/RP0/CPU0 0 0 2053 N 0 0 0 fib_mgr 303249 0/RP1/CPU0 0 0 2053 N 0 0 0 fib_mgr 94295 0/1/CPU0 0 0 2053 N 0 0 0 fib_mgr 127074 0/4/CPU1 0 0 2053 N 0 0 0 fib_mgr 94295 0/6/CPU0 0 0 2053 N 0 0 0 fib_mgr 118884 0/4/CPU0 0 0 2053 N 0 0 0 fib_mgrTable 1 and Table 1 describe the significant fields shown in the display.
show bcdl tables
To display Bulk Content Downloader (BCDL) table information, use the show bcdl tables command in EXEC mode.
Syntax Description
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The following example shows sample output using the show bcdl tables command:
RP/0/RP0/CPU0:router# show bcdl tables ipv4_rib Sun May 31 07:19:41.409 PST grp ipv4_rib, gid 2051, sg cnt 1, agent jid 111, node 0/RP0/CPU0, pulse 343, new mbr 0 sg lwg fd csmr hdlr-act dnld-act susp wait-lck seq pulse-tot pulse-out 0 2053 15 6 no no no 0 386 338 0 sgs: 1, table_cnt: 1, table_mid_cnt: 6, buf size: 124 Showing table info for 1 subgroups sg 0: has 1 tables (messages: 0, bytes: 0) table 0xe0000000: 6 members, dnld act: 0, messages: 386, bytes: 175152 cnsmr 0: pid 467088 on node 0/RP0/CPU0 cnsmr 1: pid 127074 on node 0/4/CPU1 cnsmr 2: pid 118884 on node 0/4/CPU0 cnsmr 3: pid 94295 on node 0/1/CPU0 cnsmr 4: pid 94295 on node 0/6/CPU0 cnsmr 5: pid 303249 on node 0/RP1/CPU0
The significant fields shown in the display that are not described in Table 1 or Table 1 are described in this table.
Table 3 show bcdl tables Field DescriptionsField
Description
sgs
Number of subgroups.
table_cnt
Number of tables in this subgroup.
sg
Specific subgroup for which information is provided.
has 1 tables
Number of tables in this subgroup.
messages
Messages sent that are not associated with a particular table ID.
bytes
Bytes sent that are not associated with a particular table ID.
table
Specific table ID for which information is provided.
members
Number of consumers associated with this table.
dnld act
Indicates whether or not the convergence flag has been sent.
messages
Number of messages sent for a particular table.
bytes
Number of bytes sent for a particular table.
cnsmr 0: pid 419725 on node 0/RP0/CPU0
Process ID and node information for each consumer in the specified table.
show bcdl trace
To display Bulk Content Downloader (BCDL) trace information, use the show bcdl trace command in EXEC mode.
show bcdl trace [group_name] [event] [timing] [grpsnd] [ wrapping | unique ] [hexdump] [ last n ] [reverse] [stats] [tailf] [verbose] [ file filename original location node-id | location { node-id | all } ]
Syntax Description
group_name (Optional) Displays information for a specific BCDL group.
event (Optional) Displays event trace entries.
timing (Optional) Displays timing trace entries.
grpsnd (Optional) Displays group send trace entries.
wrapping (Optional) Displays wrapping entries.
unique (Optional) Displays unique entries only, along with the count of the number of times this entry appears.
hexdump (Optional) Displays traces in hexadecimal format.
last n (Optional) Displays the last n number of traces only.
reverse (Optional) Displays the most recent traces first.
stats (Optional) Displays execution path statistics.
tailf (Optional) Displays new traces as they are added.
verbose (Optional) Displays additional internal debugging information.
file filename original location node-id (Optional) Specifies a filename and original location of the file to display.
location {node-id | all} Specifies the RP node for which to display the execution path monitoring information. The node-id argument is expressed in the rack/slot/module notation. The all keyword specifies all RP nodes.
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Examples
The following example shows sample output using the show bcdl trace command:
RP/0/RP0/CPU0:router# show bcdl trace ipv4_rib location 0/1/cpu0 Sun May 31 08:28:40.346 PST 372 wrapping entries (4096 possible, 44 filtered, 372 total) May 11 15:24:51.388 bcdl/c/ipv4_rib 0/1/CPU0 t3 LE bcdl_join_internal: timer_create ret 0, id is 11 May 11 15:24:52.417 bcdl/c/ipv4_rib 0/1/CPU0 t5 LE bcdl_join_internal: group_lookup bcdl_ipv4_rib returned gid 2051 May 11 15:24:52.441 bcdl/c/ipv4_rib 0/1/CPU0 t5 LE join hwg 2051 returns 0 May 11 15:24:52.446 bcdl/c/ipv4_rib 0/1/CPU0 t5 LE bcdl_join_internal: joined group bcdl_ipv4_rib, member count 5 May 11 15:24:53.458 bcdl/c/ipv4_rib 0/1/CPU0 t5 LE rcv gsp mtype 3: connection init sg 2 cur_seq 0 lwg_gid 2069 table tag 0x00000000 resend state yes May 11 15:24:53.459 bcdl/c/ipv4_rib 0/1/CPU0 t5 LE pc ring high water 0 -> 1, 0 bytes May 11 15:24:53.464 bcdl/c/ipv4_rib 0/1/CPU0 t3 LE c_h deliver msg_id 16 connection init, table event 0 table tag 0x00000000 May 11 15:24:53.464 bcdl/c/ipv4_rib 0/1/CPU0 t3 LE conn init, seq 64206 -> 0, sg 65534 -> 2, gid 2051, lwg gid -1 -> 2069 ...