Skip to content

Commit

Permalink
build: update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
abertschi committed Apr 20, 2024
1 parent eaa3dde commit d665e15
Showing 1 changed file with 8 additions and 5 deletions.
13 changes: 8 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,21 +35,24 @@ sudo ./install.sh
### Prepare Host
Follow up on [Prepare Host](./README-amdsev.md#prepare-host) to set up your host for SEV-SNP.
We recommend the following additional kernel arguments.
```

```sh
GRUB_CMDLINE_LINUX_DEFAULT="transparent_hugepage=never rcupdate.rcu_cpu_stall_suppress=1 nmi_watchdog=0"
```
We ran our experiments on an AMD EPYC 9124 16-Core Processor.

We ran our experiments on an AMD 4th gen EPYC 9124 16-Core Processor. However, any other AMD SEV SNP capable processor should work as well.

### VM Image
Create an Ubuntu 22.04/23.10 image in qcow2 format. See [./run.sh](./run_vm_sudo.sh) script.

### Attack
- [Sudo Attack](./userspace/attack/heckler/sudo/sudo_attack.py)
- [SSH Attack](./userspace/attack/heckler/ssh/ssh_attack.py)

### Companion Repositories:
- [heckler-kernel](https://github.com/ahoi-attacks/heckler-linux) (`./linux/{guest|host}`): Kernel code for gadget profiling
- [heckler-qemu](https://github.com/ahoi-attacks/heckler-qemu) (`./qemu`): Compatible qemu version
- [heckler-ovmf](https://github.com/ahoi-attacks/heckler-ovmf) (`./edk2`): Compatible ovmf version

These repositories are downloaded during [project build](./build.sh).

### Artifact Evaluation
This code is still a work in progress.
We plan to apply for [artifact evaluation](https://secartifacts.github.io/) when time permits.

0 comments on commit d665e15

Please sign in to comment.