GENWQE_MEMCOPY(1)

✨ genwqe_memcopy(1) ✨

okay so. bestie. welcome to the manual page for genwqe_memcopy — that's the IBM Hardware Accelerator Tool, section 1 of the manual, and yes we are going to read the whole thing together, no skimming, no scrolling past the "boring" bits, because literally every flag here matters. 🫶

---

🌸 NAME 🌸

genwqe_memcopy — the IBM Hardware Accelerator Tool. that's it, that's the name, short and iconic.

---

🎀 SYNOPSIS 🎀

genwqe_memcopy

she's a simple girl. no positional args, no nothing. it's all flags, and the flags are down below, keep reading. 💅

---

💖 DESCRIPTION 💖

here's the full menu of options, every single one of them, in order, because we don't skip:

• -h, --help — prints usage info. the "help me bestie" button. 👑
• -v, --verbose — verbose mode. she talks more. a lot more.
• -C, --card <cardno> — use this specific card for the operation. pick your fighter.
• -A, --accelerator-type=GENWQE|CAPI — pick your accelerator type. heads up: CAPI is only available for System p. ✨
• -V, --version — version info. yes it's the capital V, do not mix her up with lowercase -v, they are different girls.
• -q, --quiet — quiece output. (that's spelled "quiece" in the source and honestly? we respect it. it means quiet. shhh. 🤫)
• -c, --count <number> — do multiple memcopies. go again. and again.
• -l, --preload <number> — preload multiple ddcb's. default is 1, and it's only for the CAPI Card, so if you're not on CAPI, this one's not for you.
• -X, --cpu <cpu> — only run on this CPU. she's monogamous to one core.
• -D, --debug — create debug data on failure. so when it goes wrong, you get receipts.
• -G, --use-sglist — use the scatter gather list.
• -n, --nonblocking — use nonblcoking behavior. (yes, "nonblcoking", the typo is load-bearing, we keep it, we love it, it means nonblocking. 😭)
• -p, --patternfile <filename>] — pattern file. that closing bracket is in the original, i don't make the rules, i just report them faithfully. 🙈
• -s, --bufsize <bufsize> — buffer size. default is 4KiB.
• -i, --pgoffs_i <offs> — byte offset for the input buffer.
• -o, --pgoffs_o <offs> — byte offset for the output buffer.
• -F, --force-compare <output_data.bin> — force a compare against that output file.
• -t, --threads <num> — run <num> threads. default is 1.
• -Y, --inject-error <err> — inject errors, and the codes are: IN:0x1, OUT:0x2, SIZE:0x4, DDCB:0x8. chaos mode, but make it scientific. 💀

so like, what does she actually do? this utility sends memcopy DDCBs to the application chip unit. you can use it to check the card's health and/or to produce stress on the card to verify its correct function. it's basically a vibe check for your hardware, and your hardware had better pass. 🔥

🦋 Example: 🦋

dd if=/dev/urandom bs=4096 count=1024 of=input_data.bin
./genwqe_memcopy -C0 -F -D --patternfile input_data.bin
output_data.bin echo $?  diff input_data.bin output_data.bin echo
$?

copy it exactly, character for character, bestie — that's the whole point of an example. 👑

---

and that's the page fr fr. genwqe_memcopy 4.0.20, from August 2025, and that's your sign-off — go memcopy something, iykyk. 🌈💜