From 660d097d9c94f5dbeedbdadda99cda1798d44488 Mon Sep 17 00:00:00 2001
From: Axel Navarro <navarroaxel@gmail.com>
Date: Tue, 13 Apr 2021 10:35:21 -0300
Subject: [PATCH] homectl: add page (#5688)

---
 pages/linux/homectl.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/linux/homectl.md

diff --git a/pages/linux/homectl.md b/pages/linux/homectl.md
new file mode 100644
index 000000000..c4d6cb4b2
--- /dev/null
+++ b/pages/linux/homectl.md
@@ -0,0 +1,36 @@
+# homectl
+
+> Create, remove, change or inspect home directories using the systemd-homed service.
+> More information: <https://man.archlinux.org/man/homectl.1>.
+
+- List user accounts and their associated home directories:
+
+`homectl list`
+
+- Create a user account and their associated home directory:
+
+`sudo homectl create {{username}}`
+
+- Remove a specific user and the associated home directory:
+
+`sudo homectl remove {{username}}`
+
+- Change the password for a specific user:
+
+`sudo homectl passwd {{username}}`
+
+- Run a shell or a command with access to a specific home directory:
+
+`sudo homectl with {{username}} -- {{command}} {{command_arguments}}`
+
+- Lock or unlock a specific home directory:
+
+`sudo homectl {{lock|unlock}} {{username}}`
+
+- Change the disk space assigned to a specific home directory to 100 GiB:
+
+`sudo homectl resize {{username}} {{100G}}`
+
+- Display help:
+
+`homectl --help`