SMACLIENT(1)

✨ SMACLIENT(1) ✨

okay so bestie, listen — this is the manual page for smaclient, from the General Commands Manual section 1, and it's genuinely one of my faves 💖

🌸 NAME 🌸

smaclient — the tool for accessing z/VM System Management functions 🎀

🦋 SYNOPSIS 🦋

smaclient [FUNCTION] [OPTION] [PARAMETER]
smaclient [-?|--help]
smaclient [-T target] [-H host] [-U user] [-P pass] <function>

💜 DESCRIPTION 💜

smaclient is a tool which provides a line-mode interface to the z/VM System Management API (SMAPI) for most Unix-compatible systems such as Linux. no cap ✨

and the way it can exercise all the VM management interfaces to create, modify and destroy virtual machines without ever logging into z/VM?? it's giving main character energy fr fr 💅👑

and listen — if you just run smaclient with no arguments at all, it will print a list of available arguments and options. so helpful of it 🫶

---

👑 REQUIRED OPTIONS 👑

bestie. this one is not optional. i'm so serious. 😭

• -T, --target=TARGET — set the target image or authorization entry name 🎯

🌈 GENERAL OPTIONS 🌈

• -H, --smhost=HOST — hostname/port of SMAPI server. specify IUCV if SMAPI IUCV is desired 🌐
• -U, --smuser=USER — authorized SMAPI userid 🙋
• -P, --smpass=PASS — authorized SMAPI password 🔐
• -?, --help — output usage information 💬

🧚 FUNCTIONS 🧚

supported long function names MUST match SMAPI function name. yes, MUST. like, exactly. 🔥

for a list of supported functions, execute smaclient without arguments ✨

🍓 FILES 🍓

/etc/smaclient.conf
~/.smaclient

for /etc/smaclient.conf and ~/.smaclient, you can specify any or all of the following variables 👇

• smhost — For TCP/IP, specify the SMAPI host and port number. The format is:

hostname/portnumber

For IUCV, specify the literal "IUCV". 🛰️

• smuser — For TCP/IP, specify the userid authorized to use SMAPPI. For IUCV, there's no need to specify this, but it doesn't hurt. 🙈
• smpass — For TCP/IP, specify the corresponding password. For IUCV, there's no need to specify this, but it doesn't hurt. 🔑

an example ~/.smaclient:

smhost="myzvm/44444"
smuser="vsmuser"
smpass="secret"

⭐ AUTHOR ⭐

smaclient written by Leland Lucius one fun week in the snowy winter of 2011 ❄️ (iconic behavior honestly). Manpage written by Rafael Fonseca.

📜 LICENSE 📜

Released under the Artistic License 2.0. Full license text can be found at http://opensource.org/licenses/artistic-license-2.0

---

and that's the whole page, bestie 💖 this one lives in the General Commands Manual, it's SMACLIENT(1), and it's been serving looks ever since. mwah 🫶🎀✨