From: AsamK Date: Tue, 30 Jan 2024 16:44:51 +0000 (+0100) Subject: Deprecate daemon mode without explicit mode flag X-Git-Tag: v0.13.0~36 X-Git-Url: https://git.nmode.ca/signal-cli/commitdiff_plain/2ab5b2817e865ca474a8fde1add7304ec2c356bb?ds=sidebyside Deprecate daemon mode without explicit mode flag --- diff --git a/data/signal-cli.service b/data/signal-cli.service index 1e4a5a5c..a0bba768 100644 --- a/data/signal-cli.service +++ b/data/signal-cli.service @@ -8,7 +8,7 @@ After=network-online.target [Service] Type=dbus Environment="SIGNAL_CLI_OPTS=-Xms2m" -ExecStart=%dir%/bin/signal-cli --config /var/lib/signal-cli daemon --system +ExecStart=%dir%/bin/signal-cli --config /var/lib/signal-cli daemon --dbus-system User=signal-cli BusName=org.asamk.Signal diff --git a/data/signal-cli@.service b/data/signal-cli@.service index d96352e8..c5698ca7 100644 --- a/data/signal-cli@.service +++ b/data/signal-cli@.service @@ -8,7 +8,7 @@ After=network-online.target [Service] Type=dbus Environment="SIGNAL_CLI_OPTS=-Xms2m" -ExecStart=%dir%/bin/signal-cli -a %I --config /var/lib/signal-cli daemon --system +ExecStart=%dir%/bin/signal-cli -a %I --config /var/lib/signal-cli daemon --dbus-system User=signal-cli BusName=org.asamk.Signal diff --git a/man/signal-cli.1.adoc b/man/signal-cli.1.adoc index bd855ab4..7bc17905 100644 --- a/man/signal-cli.1.adoc +++ b/man/signal-cli.1.adoc @@ -25,7 +25,7 @@ For this use-case, it has a dbus and a JSON-RPC interface, that can be used to s For some functionality the Signal protocol requires that all messages have been received from the server. The `receive` command should be regularly executed. -In daemon mode messages are continuously received. +In daemon mode messages are by default continuously received. == Options @@ -720,16 +720,9 @@ Alternatively, specify the group IDs for which to get the attachment. === daemon -signal-cli can run in daemon mode and provides an experimental dbus or JSON-RPC interface. -If no `-a` account is given, all local accounts will be exported as separate dbus objects under the same bus name. - -*--dbus*:: -Export DBus interface on user bus. + -See **signal-cli-dbus**(5) for info on the dbus interface. - -*--dbus-system*:: -Export DBus interface on system bus. + -See **signal-cli-dbus**(5) for info on the dbus interface. +signal-cli can run in daemon mode and provides JSON-RPC or an experimental dbus interface. +If no `-a` account is given, all local accounts will be loaded. +Multiple interfaces can be used at the same time, e.g. `daemon --socket --dbus` *--socket [SOCKET]*:: Export a JSON-RPC interface on a UNIX socket (default $XDG_RUNTIME_DIR/signal-cli/socket). + @@ -744,6 +737,14 @@ Expose a JSON-RPC interface as http endpoint (default localhost:8080). The JSON-RPC endpoint is `/api/v1/rpc`. + See **signal-cli-jsonrpc**(5) for info on the JSON-RPC interface. +*--dbus*:: +Export DBus interface on user bus. + +See **signal-cli-dbus**(5) for info on the dbus interface. + +*--dbus-system*:: +Export DBus interface on system bus. + +See **signal-cli-dbus**(5) for info on the dbus interface. + *--ignore-attachments*:: Don’t download attachments of received messages. diff --git a/src/main/java/org/asamk/signal/commands/DaemonCommand.java b/src/main/java/org/asamk/signal/commands/DaemonCommand.java index 561ee8c3..f4d701b1 100644 --- a/src/main/java/org/asamk/signal/commands/DaemonCommand.java +++ b/src/main/java/org/asamk/signal/commands/DaemonCommand.java @@ -46,9 +46,7 @@ public class DaemonCommand implements MultiLocalCommand, LocalCommand { public void attachToSubparser(final Subparser subparser) { final var defaultSocketPath = new File(new File(IOUtils.getRuntimeDir(), "signal-cli"), "socket"); subparser.help("Run in daemon mode and provide a JSON-RPC or an experimental dbus interface."); - subparser.addArgument("--dbus") - .action(Arguments.storeTrue()) - .help("Expose a DBus interface on the user bus (the default, if no other options are given)."); + subparser.addArgument("--dbus").action(Arguments.storeTrue()).help("Expose a DBus interface on the user bus."); subparser.addArgument("--dbus-system", "--system") .action(Arguments.storeTrue()) .help("Expose a DBus interface on the system bus."); @@ -190,6 +188,8 @@ public class DaemonCommand implements MultiLocalCommand, LocalCommand { && httpAddress == null && inheritedChannel == null )) { + logger.warn( + "Running daemon command without explicit mode is deprecated. Use --dbus to use the dbus interface."); daemonHandler.runDbus(false); } }