From patchwork Tue Sep 26 08:41:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Felix Moessbauer X-Patchwork-Id: 1839517 X-Patchwork-Delegate: sbabic@denx.de Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20230601 header.b=JIIuSuq8; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::23f; helo=mail-lj1-x23f.google.com; envelope-from=swupdate+bncbcyiz4m3xakrb3nszkuamgqetrnzmaq@googlegroups.com; receiver=patchwork.ozlabs.org) Received: from mail-lj1-x23f.google.com (mail-lj1-x23f.google.com [IPv6:2a00:1450:4864:20::23f]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4RvtXf29TVz1yp0 for ; Tue, 26 Sep 2023 18:42:25 +1000 (AEST) Received: by mail-lj1-x23f.google.com with SMTP id 38308e7fff4ca-2c0082e04eesf115555671fa.0 for ; Tue, 26 Sep 2023 01:42:25 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1695717742; cv=pass; d=google.com; s=arc-20160816; b=WEUOfHO+ie6b/UoUqe0ROgwpEggKOg91De0KznxCrBvsyHbvtgANhybRD9tPEMRWAQ EZrhUZ1GUcNP3oLyiZNY6MMxlClRDDxtNKCgq35pANoQ51p5Kl5fXIYDzgd+fL+o3SkF viV49EeCUbDR9HosemWLVDHo8j/bY8rKKvvlWC6OBZTO0tHXVsZie/uCGV8z1DzpBzMJ FWM1pbsRKEZXUr12VMjuqqAqUjmqJ7OKlPLKfTAjZuRusnqA+1ZlP1Rwvl0t+7K0/1nu AlU3c34Tu0OkoF3Ac2b/vAkQoHgnSBChCR18sYCWVhFOW7MmHjLWyT2o7Hz4LYV1v+u9 IO+A== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to:feedback-id:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=c5FZ5UbWW7rFWJ3x4nWn0YMMUiymnvxweyFeJp60350=; fh=8m9swjqHMa8Zs6Jtx1aOGfmf2EFoFLhXt7dY/094Q7k=; b=L13IuyEaPQ7WunpsD9FTl1EKpZyiapVfbRIsdOc7eyEAHTL4uBAYfQjD3Xdwzdc6Ym PPV2wesXJY9xVY5nkLMPi5s1qOPWDKLIilYLGtYXdQ2rKjcm1MB2L9hKPBaXrVeTY38T CTmVvDdIUNGIGJbB0L51RWMnySe9qwiU+DZZMn56SHbBPoI/qBUk2pQfOYX+2vnr0nr7 cmODuEubwleIVKi8ucf2fZdsHGFlaC107EE+KRxOMiORl8bKwt463zZan0eXBpsmfPrq Vi/kMvtW0QgZwj7GYV7QWOM8OmaKjrgR7pOHHDWymJGoCNmZRg9M6bG6oi4Nbv5I4DKk yuQw== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="Mq9ca7/e"; spf=pass (google.com: domain of fm-72506-20230926084219ab726e9f7b674199f5-qludg5@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) smtp.mailfrom=fm-72506-20230926084219ab726e9f7b674199f5-QluDG5@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1695717742; x=1696322542; darn=patchwork.ozlabs.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to :x-original-authentication-results:x-original-sender:feedback-id :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:from:to:cc:subject:date:message-id:reply-to; bh=c5FZ5UbWW7rFWJ3x4nWn0YMMUiymnvxweyFeJp60350=; b=JIIuSuq8VxA6VLqNpQ0objz1aAFG0XCJcEXyvjR7eod7okJU85m2864E/olzo+jfu3 GoXN0EZDD6Rv1HmxMJGzNW7uAR2oc7sUWuzpAH1ga4caHj/6VwWEZVz5IVAmgOLzlgpw IFihWWau6h0PnNPXFKsZQXZupICfAhGy0o5WNv8C0lDbEfSNKcp0BMm3MUEIgp1tJLpp /BjuCteyEUrzfTd1/ChvH+LqpVVIauxx0xjFn46lc2tr2WWU5GlhiMk7suu9NEttdrbj Bxpu2wQY4Yc9PyYFiJU+v3Vo6kk50rnPUviwRNEdfq9QUAUeicvfNcunQgv3b4X0hwWK GR6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695717742; x=1696322542; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence:reply-to :x-original-authentication-results:x-original-sender:feedback-id :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:x-beenthere:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=c5FZ5UbWW7rFWJ3x4nWn0YMMUiymnvxweyFeJp60350=; b=EFcUW6+qRzkekPYnW/AE/I1ojsbmus7ROYx4HEAygwivPtA/jQmUptjvrpbZslsjYj sJ/FLI6k5TSEibJbPTRP7tzY0sboz6QXh5BBdTje1JVdxCkQgD7rYyjPWGL5bBY5CIC9 T6P8drPQVCvyeBeZGe0COmjHwjwQ2dS0VWgg0mh608nGsj9UKZiEKaewmSo0InJvVbbz FpF/9yx5PLPxg1omvfUOsDOBza/TScz4sw1SAvrJBuoEJwebOTy/BU/5hgI40KJj3mtP G8GJRZ1Q5r7lgVV0mIa6bAIis2EAj1gvWKSJvE78DvQJSw/dmVuTbpAYcqXnR5B49449 aNEw== X-Gm-Message-State: AOJu0YydtHbyGXIZZZ9Sj++svkidyDcsVB7+JtjuRhDpi2IRcOeGkLtE wVDXfRhv/81uKbzB8W5jF60= X-Google-Smtp-Source: AGHT+IFsOpyU7KUXzA308AkUA6tGTyIBYUHf7XQlZIGwpG2bInFmZHcXmCj+N/H8LPVyrQMUS5vDWQ== X-Received: by 2002:a2e:964d:0:b0:2bf:f9b3:d335 with SMTP id z13-20020a2e964d000000b002bff9b3d335mr7878521ljh.15.1695717742101; Tue, 26 Sep 2023 01:42:22 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a05:651c:2204:b0:2bf:f55d:1df9 with SMTP id y4-20020a05651c220400b002bff55d1df9ls847575ljq.1.-pod-prod-05-eu; Tue, 26 Sep 2023 01:42:19 -0700 (PDT) X-Received: by 2002:a05:6512:3497:b0:502:af38:3413 with SMTP id v23-20020a056512349700b00502af383413mr6181471lfr.2.1695717739782; Tue, 26 Sep 2023 01:42:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695717739; cv=none; d=google.com; s=arc-20160816; b=dDrC8Rtn0kCmVXN8VY72sZ8rcAjOU4Mk+a1t3ry6JqggglzrhDtFLWtH5/kruz88TE ggZi+GNIpvZoGu7OKGrpNHCRFNtgDbYqEEMX7HqwdfbxCBZ4/BCDPnjHepcRrKnOiGmw lLQL3vw4iWBhtp1rgUPi/sA74gxfkUnXQB2JILBG12+7+dgAOGnc7sm150Dx1U6gWU7t vNXQB9rAThOzgkWEuBD4BdS8VJzveQJoEyOshLqrlHUjVLtsdSWRnmCjtAQSqmTEib0B 7dCEqcDcqbR/qq4uWf3QeuVwyY/wWLnaiHVbapbxC/OXw+O8aTfAICIFLVeYOHqrc9KV j1dg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=feedback-id:content-transfer-encoding:mime-version:references :in-reply-to:message-id:date:subject:cc:to:from:dkim-signature; bh=SGPo7R7XPVNyV5ukwOOxIhEnlfPyDxFjlOfENhpepFI=; fh=8m9swjqHMa8Zs6Jtx1aOGfmf2EFoFLhXt7dY/094Q7k=; b=qdPIOqTIn+8Eo8vNTu5kMRGqvX0FHMhu0K2l9Y6aj3bRy/vGTzNlChhXY11KFRY70E 6Mc1gugKcJrR227fZlR20DOWZ+GZvoNbvLRbAGJQX/d8Nl/m4lBu3ihkC7VFrh+1msjp uCVtLNte/t4auhSyGGfErdPrmNgY9E3m+dC6egpeDtHtFg4HTOm9B7bzsXfwoUcnTDsr OTP62uTvLEVmHJq+xBoJg8v6kn0hkPt/nWjyxzwGSjgsPKpoOGNMNXMb2VDvzsAi42D8 KCyvwBDHbXhygxkZlsDNPp7sSxEufjXKzdXNoe1iVYwSpnQhI4Og2vbMCZsJpjj6WJ2Y BP+A== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="Mq9ca7/e"; spf=pass (google.com: domain of fm-72506-20230926084219ab726e9f7b674199f5-qludg5@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) smtp.mailfrom=fm-72506-20230926084219ab726e9f7b674199f5-QluDG5@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com Received: from mta-64-227.siemens.flowmailer.net (mta-64-227.siemens.flowmailer.net. [185.136.64.227]) by gmr-mx.google.com with ESMTPS id d7-20020a056512368700b004ff9d6b6cb0si700118lfs.2.2023.09.26.01.42.19 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 26 Sep 2023 01:42:19 -0700 (PDT) Received-SPF: pass (google.com: domain of fm-72506-20230926084219ab726e9f7b674199f5-qludg5@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) client-ip=185.136.64.227; Received: by mta-64-227.siemens.flowmailer.net with ESMTPSA id 20230926084219ab726e9f7b674199f5 for ; Tue, 26 Sep 2023 10:42:19 +0200 X-Patchwork-Original-From: "'Felix Moessbauer' via swupdate" From: Felix Moessbauer To: swupdate@googlegroups.com Cc: bage@debian.org, quirin.gylstorff@siemens.com, christian.storm@siemens.com, Felix Moessbauer Subject: [swupdate] [PATCH 2/2] docs: improve swupdate.socket systemd example Date: Tue, 26 Sep 2023 16:41:51 +0800 Message-Id: <20230926084151.966511-2-felix.moessbauer@siemens.com> In-Reply-To: <20230926084151.966511-1-felix.moessbauer@siemens.com> References: <20230926084151.966511-1-felix.moessbauer@siemens.com> MIME-Version: 1.0 X-Flowmailer-Platform: Siemens Feedback-ID: 519:519-72506:519-21489:flowmailer X-Original-Sender: felix.moessbauer@siemens.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="Mq9ca7/e"; spf=pass (google.com: domain of fm-72506-20230926084219ab726e9f7b674199f5-qludg5@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) smtp.mailfrom=fm-72506-20230926084219ab726e9f7b674199f5-QluDG5@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com X-Original-From: Felix Moessbauer Reply-To: Felix Moessbauer Precedence: list Mailing-list: list swupdate@googlegroups.com; contact swupdate+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: swupdate@googlegroups.com X-Google-Group-Id: 605343134186 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , When running under systemd, the proposed paths for sockets are below /run and not /tmp, as /tmp is always world writable. In addition, the note about default paths is changed, as there are various methods to control the location where clients expect the swupdate sockets. Signed-off-by: Felix Moessbauer --- doc/source/swupdate.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/doc/source/swupdate.rst b/doc/source/swupdate.rst index 5f39a84..2464145 100644 --- a/doc/source/swupdate.rst +++ b/doc/source/swupdate.rst @@ -758,23 +758,24 @@ activation, an accompanying systemd socket unit file Documentation=https://sbabic.github.io/swupdate [Socket] - ListenStream=/tmp/sockinstctrl - ListenStream=/tmp/swupdateprog + ListenStream=/run/sockinstctrl + ListenStream=/run/swupdateprog [Install] WantedBy=sockets.target On ``swupdate.socket`` being started, systemd creates the socket files and hands them over to SWUpdate when it starts. So, for -example, when talking to ``/tmp/swupdateprog``, systemd starts +example, when talking to ``/run/swupdateprog``, systemd starts ``swupdate.service`` and hands-over the socket files. The socket files are also handed over on a "regular" start of SWUpdate via ``systemctl start swupdate.service``. -Note that the socket paths in the two ``ListenStream=`` directives -have to match the socket paths ``CONFIG_SOCKET_CTRL_PATH`` and -``CONFIG_SOCKET_PROGRESS_PATH`` in SWUpdate's configuration. -Here, the default socket path configuration is depicted. +Note, that all dependent services need to access the swupdate +sockets via the paths specified in the ``swupdate.socket`` systemd +unit. The paths used in the example from above are not the default +swupdate socket paths, but follow the recommended directory +structure proposed by systemd. .. _systemd: https://www.freedesktop.org/wiki/Software/systemd/