Add container workflow to README
This commit is contained in:
@@ -399,6 +399,68 @@ Dla użytkownika `u1` i zadania `task4_stack_strlen` branch będzie miał nazwę
|
|||||||
u1T4a
|
u1T4a
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Kolejny krok: kontenery i debugowanie
|
||||||
|
|
||||||
|
Kontenery są potrzebne dopiero po pobraniu karty pracy, kiedy chcesz uruchomić
|
||||||
|
albo debugować konkretne zadanie. `rvctl` korzysta z narzędzia
|
||||||
|
`rv32i-hazard3-student-env`, które trafia do workspace pod:
|
||||||
|
|
||||||
|
```text
|
||||||
|
~/dev/workspace/rv/tools/rv32i-hazard3-student-env
|
||||||
|
```
|
||||||
|
|
||||||
|
Najpierw sprawdź dostępne profile i pobierz albo odśwież repo środowiska:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./rvctl env list
|
||||||
|
./rvctl env sync
|
||||||
|
```
|
||||||
|
|
||||||
|
Po synchronizacji workspace ma dodatkowe narzędzie pod `tools`:
|
||||||
|
|
||||||
|
```text
|
||||||
|
~/dev/workspace/rv
|
||||||
|
├── meta
|
||||||
|
│ └── workspace-info
|
||||||
|
├── tools
|
||||||
|
│ ├── rv-launcher
|
||||||
|
│ └── rv32i-hazard3-student-env
|
||||||
|
├── tokens
|
||||||
|
│ └── tokens.json
|
||||||
|
└── series
|
||||||
|
└── inf
|
||||||
|
└── lab-rv32i-strlen-bss-data-stack
|
||||||
|
```
|
||||||
|
|
||||||
|
Środowisko ma dwa profile:
|
||||||
|
|
||||||
|
- `rv32i` - Hazard3/RISC-V, `gdb-multiarch`, `nvim` i `tmux`,
|
||||||
|
- `host` - natywne uruchamianie i debugowanie C przez `clang` albo `gcc`,
|
||||||
|
`gdb`, `nvim` i `tmux`.
|
||||||
|
|
||||||
|
Zbuduj potrzebne obrazy:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./rvctl env build rv32i
|
||||||
|
./rvctl env build host
|
||||||
|
```
|
||||||
|
|
||||||
|
Dla pobranej karty `inf bss` możesz uruchomić debugowanie w obu profilach:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./rvctl debug rv32i 4
|
||||||
|
./rvctl debug host 4
|
||||||
|
```
|
||||||
|
|
||||||
|
Profil `host` ma też szybkie uruchomienie bez sesji debuggera:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./rvctl run host 4
|
||||||
|
```
|
||||||
|
|
||||||
|
Szczegóły komend, warianty `--dry-run`, `--instance`, `--editor` i ograniczenia
|
||||||
|
profili są w `doc/containers.md`.
|
||||||
|
|
||||||
## Dokumentacja
|
## Dokumentacja
|
||||||
|
|
||||||
- `doc/rvctl.md` - techniczna dokumentacja CLI: wszystkie komendy, argumenty
|
- `doc/rvctl.md` - techniczna dokumentacja CLI: wszystkie komendy, argumenty
|
||||||
|
|||||||
Reference in New Issue
Block a user