[libvirt] [PATCH 2/3] virsh: add set-user-password command

[Ján Tomko]

Expose the virDomainSetUserPassword API in virsh:
virsh set-user-password dom 123456 user

For root, the username can be omitted:
virsh set-user-password dom 123456
---
 tools/virsh-domain.c | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/virsh.pod      | 11 ++++++++
 2 files changed, 87 insertions(+)

diff --git a/tools/virsh-domain.c b/tools/virsh-domain.c
index 20f8c75..a654623 100644
--- a/tools/virsh-domain.c
+++ b/tools/virsh-domain.c
@@ -5381,6 +5381,76 @@ cmdScreenshot(vshControl *ctl, const vshCmd *cmd)
 }
 
 /*
+ * "set-user-password" command
+ */
+static const vshCmdInfo info_set_user_password[] = {
+    {.name = "help",
+     .data = N_("set the user password inside the domain")
+    },
+    {.name = "desc",
+     .data = N_("changes the password of the specified user inside the domain")
+    },
+    {.name = NULL}
+};
+
+static const vshCmdOptDef opts_set_user_password[] = {
+    {.name = "domain",
+     .type = VSH_OT_DATA,
+     .flags = VSH_OFLAG_REQ,
+     .help = N_("domain name, id or uuid")
+    },
+    {.name = "password",
+     .type = VSH_OT_DATA,
+     .flags = VSH_OFLAG_REQ,
+     .help = N_("the new password")
+    },
+    {.name = "user",
+     .type = VSH_OT_STRING,
+     .help = N_("the username")
+    },
+    {.name = "crypted",
+     .type = VSH_OT_BOOL,
+     .help = N_("the password is already crypted")
+    },
+    {.name = NULL}
+};
+
+static bool
+cmdSetUserPassword(vshControl *ctl, const vshCmd *cmd)
+{
+    virDomainPtr dom;
+    const char *name;
+    const char *password = NULL;
+    const char *user = NULL;
+    unsigned int flags = 0;
+    bool ret = false;
+
+    if (vshCommandOptBool(cmd, "crypted"))
+        flags = VIR_DOMAIN_PASSWORD_CRYPTED;
+
+    if (vshCommandOptStringReq(ctl, cmd, "user", &user) < 0)
+        return false;
+
+    if (vshCommandOptStringReq(ctl, cmd, "password", &password) < 0)
+        return false;
+
+    if (!user)
+        user = "root";
+
+    if (!(dom = vshCommandOptDomain(ctl, cmd, &name)))
+        return false;
+
+    if (virDomainSetUserPassword(dom, user, password, flags) < 0)
+        goto cleanup;
+
+    vshPrint(ctl, _("Password set successfully for %s in %s"), user, name);
+    ret = true;
+
+ cleanup:
+    virDomainFree(dom);
+    return ret;
+}
+/*
  * "resume" command
  */
 static const vshCmdInfo info_resume[] = {
@@ -13159,6 +13229,12 @@ const vshCmdDef domManagementCmds[] = {
      .info = info_screenshot,
      .flags = 0
     },
+    {.name = "set-user-password",
+     .handler = cmdSetUserPassword,
+     .opts = opts_set_user_password,
+     .info = info_set_user_password,
+     .flags = 0
+    },
     {.name = "setmaxmem",
      .handler = cmdSetmaxmem,
      .opts = opts_setmaxmem,
diff --git a/tools/virsh.pod b/tools/virsh.pod
index 1bb655b..9bd52f2 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -2015,6 +2015,17 @@ the value from the host, use the B<virsh memtune> command. In order to view
 the current memory in use and the maximum value allowed to set memory, use
 the B<virsh dominfo> command.
 
+=item B<set-user-password> I<domain> I<password> [I<user>] [I<--crypted>]
+
+Set the password for the I<user> account in the guest domain.
+If the user is omitted, root is assumed by virsh.
+
+If I<--crypted> is specified, the password is assumed to be crypted
+already by crypt(3).
+
+For QEMU/KVM, this requires the guest agent to be configured
+and running.
+
 =item B<setmaxmem> I<domain> B<size> [[I<--config>] [I<--live>] |
 [I<--current>]]
 
-- 
2.0.5