xref: /aosp_15_r20/external/bcc/QUICKSTART.md (revision 387f9dfdfa2baef462e92476d413c7bc2470293e)
1*387f9dfdSAndroid Build Coastguard Worker# Quick Start Guide
2*387f9dfdSAndroid Build Coastguard Worker
3*387f9dfdSAndroid Build Coastguard WorkerA Docker container is provided for user to try out [bcc](https://github.com/iovisor/bcc).
4*387f9dfdSAndroid Build Coastguard Worker
5*387f9dfdSAndroid Build Coastguard WorkerFrom your host shell:
6*387f9dfdSAndroid Build Coastguard Worker```bash
7*387f9dfdSAndroid Build Coastguard Workerdocker run -it --rm \
8*387f9dfdSAndroid Build Coastguard Worker  --privileged \
9*387f9dfdSAndroid Build Coastguard Worker  -v /lib/modules:/lib/modules:ro \
10*387f9dfdSAndroid Build Coastguard Worker  -v /usr/src:/usr/src:ro \
11*387f9dfdSAndroid Build Coastguard Worker  -v /etc/localtime:/etc/localtime:ro \
12*387f9dfdSAndroid Build Coastguard Worker  --workdir /usr/share/bcc/tools \
13*387f9dfdSAndroid Build Coastguard Worker  zlim/bcc
14*387f9dfdSAndroid Build Coastguard Worker```
15*387f9dfdSAndroid Build Coastguard Worker
16*387f9dfdSAndroid Build Coastguard WorkerNow, from the container shell, you can try the various pre-installed bcc tools.
17*387f9dfdSAndroid Build Coastguard Worker
18*387f9dfdSAndroid Build Coastguard WorkerFor examples, please refer to the [tutorial](docs/tutorial.md#1-general-performance).
19*387f9dfdSAndroid Build Coastguard Worker
20*387f9dfdSAndroid Build Coastguard WorkerIf you wish to install bcc on your host, please refer to [INSTALL.md](INSTALL.md).
21