Message ID | 20231023022529.15081-6-felix.moessbauer@siemens.com |
---|---|
State | Changes Requested |
Headers | show
Return-Path: <swupdate+bncBCYIZ4M3XAKRBW5T26UQMGQEP6VI5EA@googlegroups.com> 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=pjTK687l; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::338; helo=mail-wm1-x338.google.com; envelope-from=swupdate+bncbcyiz4m3xakrbw5t26uqmgqep6vi5ea@googlegroups.com; receiver=patchwork.ozlabs.org) Received: from mail-wm1-x338.google.com (mail-wm1-x338.google.com [IPv6:2a00:1450:4864:20::338]) (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 4SDJwb23zvz23jn for <incoming@patchwork.ozlabs.org>; Mon, 23 Oct 2023 13:26:39 +1100 (AEDT) Received: by mail-wm1-x338.google.com with SMTP id 5b1f17b1804b1-408534c3ec7sf13970345e9.1 for <incoming@patchwork.ozlabs.org>; Sun, 22 Oct 2023 19:26:39 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1698027995; cv=pass; d=google.com; s=arc-20160816; b=qZf2emHSfatpecZ2C7tlTJk7OvwxRzGXR8oHAsFaYruWJFDvKpbcbHC/KRJh/2Rfbz kOnFffGDiVg5UDQhdy5U8PP+Pz+tM7ejqgOFsM0anFzB2e3yWXBjIN7shbvzaFvDgYWx BOhmDmjNUaKBxnlp+q9cUX2b+wlplSt4uJ64l5Qd2ZkwtwfO5p9S7bNfaVV9DBzN/yK4 QG/ofuRWlHker1KBrej4BYasL/M1DPiaIq6SMVQFv6/JtvMgEa6+u1RQeVrhm2EYOju2 g4z3y0vZzC00fW4ieXHI1C4lHnEwa2z4u8lF3IPRzhTrq/SLqWTdITY5477YMjIKaTUt cufg== 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=o4xcXStjAUDEEPzEs2vkqdM6lpv0dB8XmMfDQ/nd1s0=; fh=ma+8xbVUwT7un24q/wzzAlfUmlwoIqKltsq5mz8D4ig=; b=ailqrSEwGAzu+NU0BtwGkZ/rsUlK9cgJvLLmoy6RLZzM26avHDBtbdf/3SVyxUIm1Q trGR/PMjmvRh9SOS08ezZUelMcUXYzZHHff8SSNXUaZsZZa5EJaythuMpsqYoUS2QZPr 7ZHgqHiUrQcRZzQEVO45mSB8NfRC5RkXprEfJ1QKgtYnbP5rH03FapjkQILCB7wF8qk0 /Gp3rnw4VoSjqztiOC9Py9Xoburuwmj7gX1tG3drEI+VN3j6mb8sVvOTgXjlahXU6nxC KCzidsxOxFdx0gVo3nAM+RiBXLbuta309zPvMCs6MfJx4LdNfVYii2AMwY7U66/NmgXG KpJw== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b=Em+ceU9L; spf=pass (google.com: domain of fm-72506-2023102302263397fbc74244e9451098-hpp66y@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) smtp.mailfrom=fm-72506-2023102302263397fbc74244e9451098-Hpp66Y@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=1698027995; x=1698632795; 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=o4xcXStjAUDEEPzEs2vkqdM6lpv0dB8XmMfDQ/nd1s0=; b=pjTK687l8XN2W9NthzAHqMoChJuQkP+sjFigR7fFVZab3keRrkCOiwr193m3ObarrC jFCGvFyGIiULeV2upUGD64Z2JYSuhUOt1kDKyeO6tCSZM13sI4q22KwbumTmUJrxhGM5 8MnbwBb6/p0Jw3XzSxZU05WA+JLa9MTWqUzANOVrWRqJ2Zee7gefM8igmv5cFA84OZp7 /PMMie3Vg5S3fCxRzO4Lq+B27YTDrCw9HDavQnY2qm93hPJwYJ3y3Dkeg5X00FE4+qBQ Jdr1bSZJuZ+e2Cdoqguh1LD5YQFJ9U+CGiOc6aqowSMkbBFiTQe/BLvDB4E7HRb2Vqur 267Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1698027995; x=1698632795; 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=o4xcXStjAUDEEPzEs2vkqdM6lpv0dB8XmMfDQ/nd1s0=; b=BFAx8nPJl4Xvo/3TxZxueyJIEFYmIArcN3JeB1Ulkj7DOpM8D8qoIErs1duo50nHI6 490jBF5SPGTjIMO+lAmfJuSgnXmbKvr5NbJs1X3l7GjCI4ZMwlo7GqtWvJI3X4RYwvnc TH1rrdNLKhCLQJyWiJWK1pYT+AMlhCwTMoYkzQ6uIJ6uExF9ObDMIQ0Ad/1URQLcFQRn 7g8GZ1AXaePBZdlrFysUoU4AhfqHJXFdbaG2F71thOKP4UK+UXZonTZW+lARWQw6EhBP 6vUbt576U7eUAYqDngLIGUQCdfb6HN/NNiDRFj9CaoNtkDD+MCX0mNShpU1dJlB4DhpM 8iIA== X-Gm-Message-State: AOJu0YyBXL5sHDx6Jv5czzWh8ConHHcBGdaE51hamVrayVhswbNGk2AX QKoi3E+sLK/OA5uuN4fIm1g= X-Google-Smtp-Source: AGHT+IHrR03S0kspJZi/hlX5IPzRAfE2QKKve6ZxPWPf97M/jySKasf7hHz6Rzs4nbw78s0eS2iMxQ== X-Received: by 2002:a5d:4407:0:b0:31f:db1b:7296 with SMTP id z7-20020a5d4407000000b0031fdb1b7296mr4909949wrq.21.1698027995554; Sun, 22 Oct 2023 19:26:35 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a05:6000:2ce:b0:329:22d9:9fe8 with SMTP id o14-20020a05600002ce00b0032922d99fe8ls1055870wry.0.-pod-prod-08-eu; Sun, 22 Oct 2023 19:26:33 -0700 (PDT) X-Received: by 2002:a5d:6508:0:b0:32d:be44:f70c with SMTP id x8-20020a5d6508000000b0032dbe44f70cmr5755063wru.7.1698027993681; Sun, 22 Oct 2023 19:26:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698027993; cv=none; d=google.com; s=arc-20160816; b=GU2bnw16GwMQQQhft+IOX9n75AFCRpEaz4LeCQkoKB522fXwUZHPFi3oKRk1z8a62Y UFxoz9wqLCV3llSrrjXunMl1VxxQ7I16EPZM8/ZzGDJgx1A6SSF6t2PsYaX3MMOVllDP 4xzNaR5z2gYzjH5xgg0qYKNHX4XCWdO474P4ym3ebxWGgsEOBu7BNvQQoeDO69edGzvV PcDGjwTsYFp1uImx/ypNk3i42UXXHmHNZxmHvg1FbFh5oSCY1vCSQcTMxlmD/rLLWofJ Tdf/X2WqC1jITMjorYwGoFBTYQhSMusxXkyYEK1XVz/7mM9HYkcM/hPy0uObd0VX1S7q DuVQ== 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=1y9JGB+LFOII7wnY3VosRU+wt28yXttFegouYp2D1bI=; fh=ma+8xbVUwT7un24q/wzzAlfUmlwoIqKltsq5mz8D4ig=; b=va2v1+6pFtV2ZqSgo1sehYHkyA+60oQYW5u7tlHPxIWT/3M9HHLsW9laJNw8qQ8gYf kIw9zb3zFMvoj3OfoBs6Cfj5mAdh1zy1QPbKqvgyxHh0mhp6aIjuCzJqP9I3nIGWg//z PRc3OUrDmJMASQGRTrpMfy/K8YialNpo56imeKGQqNiGU5LrG/3lEamCrnzsD2Qn3Upi pRDilmnyotWuYx34rhhGeFQb6iXuxMvRWQtsiORF35V3MmP3vG3eyIaywGPjbNHQ4ScQ 2t4sv1ozjCUSP4aPz97cvwPRa8TbSqcR6i5jEok7i22ikcXsBRzGB0lo2vAujTqFdjeS H5FQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b=Em+ceU9L; spf=pass (google.com: domain of fm-72506-2023102302263397fbc74244e9451098-hpp66y@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) smtp.mailfrom=fm-72506-2023102302263397fbc74244e9451098-Hpp66Y@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com Received: from mta-65-227.siemens.flowmailer.net (mta-65-227.siemens.flowmailer.net. [185.136.65.227]) by gmr-mx.google.com with ESMTPS id j18-20020adff012000000b0031fe51902bdsi229371wro.0.2023.10.22.19.26.33 for <swupdate@googlegroups.com> (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sun, 22 Oct 2023 19:26:33 -0700 (PDT) Received-SPF: pass (google.com: domain of fm-72506-2023102302263397fbc74244e9451098-hpp66y@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) client-ip=185.136.65.227; Received: by mta-65-227.siemens.flowmailer.net with ESMTPSA id 2023102302263397fbc74244e9451098 for <swupdate@googlegroups.com>; Mon, 23 Oct 2023 04:26:33 +0200 From: "'Felix Moessbauer' via swupdate" <swupdate@googlegroups.com> To: swupdate@googlegroups.com Cc: quirin.gylstorff@siemens.com, christian.storm@siemens.com, Felix Moessbauer <felix.moessbauer@siemens.com> Subject: [swupdate] [PATCH 5/5] docs: improve swupdate.socket systemd example Date: Mon, 23 Oct 2023 10:25:29 +0800 Message-Id: <20231023022529.15081-6-felix.moessbauer@siemens.com> In-Reply-To: <20231023022529.15081-1-felix.moessbauer@siemens.com> References: <20231023022529.15081-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=Em+ceU9L; spf=pass (google.com: domain of fm-72506-2023102302263397fbc74244e9451098-hpp66y@rts-flowmailer.siemens.com designates 185.136.65.227 as permitted sender) smtp.mailfrom=fm-72506-2023102302263397fbc74244e9451098-Hpp66Y@rts-flowmailer.siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com X-Original-From: Felix Moessbauer <felix.moessbauer@siemens.com> Reply-To: Felix Moessbauer <felix.moessbauer@siemens.com> Content-Type: text/plain; charset="UTF-8" Precedence: list Mailing-list: list swupdate@googlegroups.com; contact swupdate+owners@googlegroups.com List-ID: <swupdate.googlegroups.com> X-Spam-Checked-In-Group: swupdate@googlegroups.com X-Google-Group-Id: 605343134186 List-Post: <https://groups.google.com/group/swupdate/post>, <mailto:swupdate@googlegroups.com> List-Help: <https://groups.google.com/support/>, <mailto:swupdate+help@googlegroups.com> List-Archive: <https://groups.google.com/group/swupdate List-Subscribe: <https://groups.google.com/group/swupdate/subscribe>, <mailto:swupdate+subscribe@googlegroups.com> List-Unsubscribe: <mailto:googlegroups-manage+605343134186+unsubscribe@googlegroups.com>, <https://groups.google.com/group/swupdate/subscribe> |
Series | Rework socket creation to better integrate with systemd | expand |
diff --git a/doc/source/swupdate.rst b/doc/source/swupdate.rst index 5f39a84..b94c6d6 100644 --- a/doc/source/swupdate.rst +++ b/doc/source/swupdate.rst @@ -758,23 +758,22 @@ 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. .. _systemd: https://www.freedesktop.org/wiki/Software/systemd/
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 <felix.moessbauer@siemens.com> --- doc/source/swupdate.rst | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-)