diff options
| author | Maximilian Bosch <maximilian@mbosch.me> | 2018-01-04 12:57:15 +0100 |
|---|---|---|
| committer | Maximilian Bosch <maximilian@mbosch.me> | 2018-01-06 10:09:18 +0100 |
| commit | e18b0b6033eb17c1aec48d931900f5debae9f4ef (patch) | |
| tree | d6c2724df7d61a4d3b77b43ccf272bbb1784542e /nixos/doc/manual/development | |
| parent | 5e85657ba5763b496388b9820519ec99a238f613 (diff) | |
| download | nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.tar nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.tar.gz nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.tar.bz2 nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.tar.lz nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.tar.xz nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.tar.zst nixpkgs-e18b0b6033eb17c1aec48d931900f5debae9f4ef.zip | |
test-driver: mention `$user` argument in the NixOS manual and the Impala release notes
Diffstat (limited to 'nixos/doc/manual/development')
| -rw-r--r-- | nixos/doc/manual/development/writing-nixos-tests.xml | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/nixos/doc/manual/development/writing-nixos-tests.xml b/nixos/doc/manual/development/writing-nixos-tests.xml index 7b25a39e83b..a8f6aa00858 100644 --- a/nixos/doc/manual/development/writing-nixos-tests.xml +++ b/nixos/doc/manual/development/writing-nixos-tests.xml @@ -272,8 +272,37 @@ startAll; </listitem> </varlistentry> + <varlistentry> + <term><methodname>systemctl</methodname></term> + <listitem> + <para>Runs <literal>systemctl</literal> commands with optional support for + <literal>systemctl --user</literal></para> + <para> + <programlisting> + $machine->systemctl("list-jobs --no-pager"); // runs `systemctl list-jobs --no-pager` + $machine->systemctl("list-jobs --no-pager", "any-user"); // spawns a shell for `any-user` and runs `systemctl --user list-jobs --no-pager` + </programlisting> + </para> + </listitem> + </varlistentry> + </variablelist> </para> +<para> + To test user units declared by <literal>systemd.user.services</literal> the optional <literal>$user</literal> + argument can be used: + + <programlisting> + $machine->start; + $machine->waitForX; + $machine->waitForUnit("xautolock.service", "x-session-user"); + </programlisting> + + This applies to <literal>systemctl</literal>, <literal>getUnitInfo</literal>, + <literal>waitForUnit</literal>, <literal>startJob</literal> + and <literal>stopJob</literal>. +</para> + </section> |