summaryrefslogtreecommitdiffstats
path: root/man/homectl.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: asorted fixesYu Watanabe8 days1-1/+1
| | | | Closes #35307.
* docs,man: Avoid some ambiguous uses of "may not"Colin Watson2024-05-081-1/+1
| | | | | | | | | | | | Like much English text, the systemd documentation uses "may not" in the sense of both "will possibly not" and "is forbidden to". In many cases this is OK because the context makes it clear, but in others I felt it was possible to read the "is forbidden to" sense by mistake: in particular, I tripped over "the target file may not exist" in systemd.unit(5) before realizing the correct interpretation. Use "might not" or "may choose not to" in these cases to make it clear which sense we mean.
* man: fix incorrect XML in man pageSam Leonard2024-04-151-85/+85
|
* homework: Implement offline updatesAdrian Vovk2024-03-231-0/+10
| | | | | | This makes it possible to update a home record (and blob directory) of a home area that's either completely absent (i.e. on a USB stick that's unplugged) or just inaccessible due to lack of authentication
* user-record: Add preferredSession{Type,Launcher}Adrian Vovk2024-03-011-0/+22
| | | | | | | These will be used by display managers to pre-select the user's preferred desktop environment and display server type. On homed, the display manager will also be able to set these fields to cache the user's last selection.
* home: fix typoYu Watanabe2024-02-201-1/+1
| | | | | Follow-up for 25c89b89771adf3251b2398eaddc3a49c22752e3 and a4d72746c776f820a440d72eaadd49ad158e10dc.
* homectl: Add flags to edit blob directoriesAdrian Vovk2024-02-191-0/+34
| | | | | | | | | | | | | | | | | | | This makes it possible to edit blob directories using homectl. The following syntax is available: * `--blob-directory=/path/somewhere`: Replaces the entire blob directory with the contents of /path/somewhere * `--blob-directory=foobar=/path/somewhere`: Replaces just the file foobar in the blob directory with the contents of /path/somewhere * `--blob-directory=foobar=`: Deletes the file foobar from the blob directory * `--blob-directory=`: Resets all previous flags * `--avatar=`, etc: Shortcuts for `--blob-directory=FILENAME=` for the known files in the blob directory
* user-record: Add languages fieldAdrian Vovk2024-02-131-4/+5
| | | | | | | | | | | | | | | | This field is like preferredLanguage, but takes a priority list of languages instead. If an app isn't translated into a user's primary language, it can fall back to one of the other languages in the list thus making the app more accessible to the user. For instance: in my experience, many Ukrainians are fluent in Russian, often significantly better than English (especially if they are of a generation that grew up during the USSR). Such a person might set this new variable to ["uk_UA.UTF-8", "ru_UA.UTF-8"] so that software that lacks Ukrainian translations will first try Russian translations before defaulting to English. Fixes #31290
* man: fix references to systemd.exec(5)Lennart Poettering2024-01-111-1/+1
| | | | | | For some reason the section for the systemd.exec man page was added incorrectly and then copypasted everywhere else incorrectly too. Let's fix that.
* man: use same version in public and system ident.David Tardon2023-12-251-1/+1
|
* man: use <simplelist> for 'See also' sectionsDavid Tardon2023-12-231-8/+8
| | | | | This is just a slight markup improvement; there should be no difference in rendering.
* homectl: add "firstboot" commandLennart Poettering2023-12-181-0/+54
| | | | | | | This extends what systemd-firstboot does and runs on first boots only and either processes user records passed in via credentials to create, or asks the user interactively to create one (only if no regular user exists yet).
* man: document that changing --uid= doesn't workLennart Poettering2023-11-081-0/+5
| | | | Fixes: #28982
* man: update version informationAbderrahim Kitouni2023-09-191-4/+10
| | | | | | | | As I noticed a lot of missing information when trying to implement checking for missing info. I reimplemented the version information script to be more robust, and here is the result. Follow up to ec07c3c80b2b1bfa6788500202006ff85f5ae4f4
* man: add version infoAbderrahim Kitouni2023-08-291-68/+204
| | | | | | | | This tries to add information about when each option was added. It goes back to version 183. The version info is included from a separate file to allow generating it, which would allow more control on the formatting of the final output.
* treewide: fix "an" before consonant U soundsJoerg Behrmann2023-07-061-1/+1
| | | | | | The article "a" goes before consonant sounds and "an" goes before vowel sounds. This commit changes an to a for UKI, UDP, UTF-8, URL, UUID, U-Label, UI and USB, since they start with the sound /ˌjuː/.
* homectl: make the new caps field configurable via homectlLennart Poettering2023-02-281-0/+13
|
* Implement --luks-pbkdf-force-iterations for homedAidan Dang2022-12-061-0/+1
|
* Implement --luks-sector-size for homedAidan Dang2022-10-071-0/+1
|
* man/homectl: adjust man page to match codeZbigniew Jędrzejewski-Szmek2022-05-261-2/+7
| | | | | Fixes #22966. Since there are competing conventions, let's not change our code, but make the docs match what is implemented.
* cryptenroll,homectl: Introduce --fido2-credential-algorithm optionMkfsSion2022-04-221-0/+13
| | | | | * Some authenticators(like Yubikey) support credential algorithm other than ES256 * Introduce a new option so users can make use of it
* man: various issues reported in #22432Zbigniew Jędrzejewski-Szmek2022-02-231-6/+6
| | | | Fixes #22432.
* homectl: add new "homectl rebalance" commandLennart Poettering2021-11-251-0/+12
| | | | | Let's add an explicit, synchronous command to request immediate rebalancing and wait for it.
* homectl: expose new rebalanceWeight JSON use record fieldLennart Poettering2021-11-251-2/+20
|
* man: "-j", not "-J" is the shortcut for JSON mode in homectlLennart Poettering2021-11-251-2/+2
| | | | The code and --help text got this right, hence fix the man page
* Merge pull request #21440 from poettering/homed-initial-fs-sizeLennart Poettering2021-11-231-4/+7
|\ | | | | homed: also support minimizing/maximizing home dirs when creating them
| * man: document min/max for --disk-space= tooLennart Poettering2021-11-231-4/+7
| |
* | man/doc: document auto resize modesLennart Poettering2021-11-231-0/+20
|/
* FIDO2 device removal instructions (#21426)Robert-L-Turner2021-11-221-0/+3
| | | | | * man: document FIDO2 device removal Indicate to users how to remove FIDO2 device in the --fido2-device=path section by setting path to an empty string (""). Tested on systemd 249 (249.6-3-arch)
* homectl: parse "min" and "max" as special disk size valuesLennart Poettering2021-11-191-1/+5
|
* doc: document the new luksExtraMountOptions conceptLennart Poettering2021-11-121-0/+8
|
* homework: allow specifying explicit additional mount options when using CIFS ↵Lennart Poettering2021-10-271-1/+5
| | | | | | | | backend This is useful since certain shares can only be mounted with additional mount flags. For example the SMB share in modern AVM Fritz!Boxes requires "noserverino" to be set to work from Linux.
* homework: allow specifying a dir component in CIFS servicesLennart Poettering2021-10-271-2/+5
| | | | | | | | | | Allow specifying CIFS services in the format //host/service/subdir/… to allow multiple homedirs on the same share, and not in the main dir of the share. All other backends allow placing the data store at arbitrary places, let's allow this too for the CIFS backend. This is particularly useful for testing.
* homed: optionally, drop caches on logoutLennart Poettering2021-10-111-0/+11
| | | | Fixes: #20857
* homectl: allow --setenv=FOOZbigniew Jędrzejewski-Szmek2021-08-111-5/+9
|
* homectl: store FIDO2 up/uv/clientPin fields in user records tooLennart Poettering2021-06-011-0/+29
| | | | | | | | | | | | This catches up homed's FIDO2 support with cryptsetup's: we'll now store the uv/up/clientPin configuration at enrollment in the user record JSON data, and use it when authenticating with it. This also adds explicit "uv" support: we'll only allow it to happen when the client explicity said it's OK. This is then used by clients to print a nice message suggesting "uv" has to take place before retrying allowing it this time. This is modelled after the existing handling for "up".
* homectl,TEST-46: fix test and fix homectl return value, update docsZbigniew Jędrzejewski-Szmek2021-04-081-0/+4
| | | | | The usual: the test wasn't testing, so we didn't notice that the command wasn't returning as expected.
* man: rename less-variables→common-variablesZbigniew Jędrzejewski-Szmek2021-03-011-1/+1
| | | | Some are not about less, e.g. $SYSTEMD_URLIFY.
* tree-wide: fix typoYu Watanabe2020-12-161-1/+1
|
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* Fix typoSorin Ionescu2020-11-011-1/+1
|
* man: reword description of KillOnlyUsers=/KillExcludeUsers=Zbigniew Jędrzejewski-Szmek2020-10-051-3/+3
| | | | Fixes #17177.
* man: reword of fido2 key derivationZbigniew Jędrzejewski-Szmek2020-10-051-5/+5
| | | | | | | "keyed by" is indeed a bit jargony. Say " a HMAC hash of the salt combined with an internal secret key" instead. For #17177.
* Merge pull request #17213 from keszybz/man-cleanupsLennart Poettering2020-10-011-1/+1
|\ | | | | Fix links in man pages
| * man: correct various linksZbigniew Jędrzejewski-Szmek2020-09-301-1/+1
| | | | | | | | As usual, linkchecker ftw!
* | homed: explicitly deactivate all home directories on shutdownLennart Poettering2020-09-301-0/+9
|/ | | | | | | | | | | | | | | | | | | | Let's explicitly deactivate all home dirs on shutdown, in order to properly synchronizing unmounting and avoiding blocking devices. Previously, we'd rely on automatic deactivation when home directories become unused. However, that scheme is asynchronous, and ongoing deactviations might conflicts with attempts to unmount /home. Let's fix that by providing an explicit service systemd-homed-activate.service whose only job is to have a ExecStop= line that explicitly deactivates all home directories on shutdown. This service can the be ordered after home.mount and similar, ensuring that we'll first deactivate all homes before deactivating /home itself during shutdown. This is kept separate from systemd-homed.service so that it is possible to restart systemd-homed.service without deactivating all home directories. Fixes: #16842
* man: assorted small fixesZbigniew Jędrzejewski-Szmek2020-09-301-2/+2
| | | | This is almost all of #17177.
* man: explain why TZ=: is usedZbigniew Jędrzejewski-Szmek2020-09-301-5/+7
| | | | | | | | | | | Also, reword the description a bit. "As a string" is meaningless in the context of commandline arguments, where evyrything is a string. This is not a strongly-typed programming language where 5 is a number but "5" is something completely different. Here both 5 and "5" are indistinguishable. The original text was trying to say that a location name should be given and not a number, so say "time zone location name". For #17177.
* homed: make clean that --storage=directory ↵Lennart Poettering2020-09-181-4/+7
| | | | | | | | | | | | --image-path=/dev/some-block-device is not supported The directory backend needs a file system path, and not a raw block device. That's only supported for the LUKS2 backend. Let's make this clearer in the man page and also generate a better error message if attempted anyway. Fixes: #17068
* man: document new homectl --recovery-key= switchLennart Poettering2020-08-251-0/+10
|
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-01 20:24:17 +0100