From nobody Fri May 17 06:43:13 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1693608108; cv=none; d=zohomail.com; s=zohoarc; b=gIMBAEMicjYK/TOyKIJ+Qjiypc1X71RGBiQumaPr6lo0QLK3lOaiQx6XP/gFaFbWFbuPuRVKFOcZcQed4Olem9S566rGDuj/a/lcxmSpyK8phVXBMU7YTm7QQKdKQHZRCz50euz+mZSP1DG6ldd1NgzNhe21gHmPBPFmhOoTr+Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1693608108; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=eCn9AyOH67f/AJEJuQQKE3J2U+c48WvkToFa+7Cxw7E=; b=V5OGSBh22dfInVOiZANL1S1BDfOvt+t64s79yzjGR1z/2sTBMQTsii1P80zDJqW6E3bHYfB/pssOOyV3Uo4AIX6ksFIicCpXhWpZB+qvy3kcyfyN3r+QRYqhYz6rj8QJv1NQWJN3xhtYvKqvZuUPElKYwRaeQUw7WvohsN4AUSk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1693608108796724.4708114936163; Fri, 1 Sep 2023 15:41:48 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-175-LgnR1Il8PqWFrO4RME2STw-1; Fri, 01 Sep 2023 18:41:45 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7A63790A7E5; Fri, 1 Sep 2023 22:41:43 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1F9FD1460FF3; Fri, 1 Sep 2023 22:41:39 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id AD6771946A46; Fri, 1 Sep 2023 22:41:39 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 1EF1C19465B7 for ; Fri, 1 Sep 2023 22:41:38 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 091A240C84A5; Fri, 1 Sep 2023 22:41:38 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast02.extmail.prod.ext.rdu2.redhat.com [10.11.55.18]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 015954069776 for ; Fri, 1 Sep 2023 22:41:37 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id D65248015AA for ; Fri, 1 Sep 2023 22:41:37 +0000 (UTC) Received: from mail-ej1-f70.google.com (mail-ej1-f70.google.com [209.85.218.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-92-pi_QecNoOv-Twv9RHm5VcQ-1; Fri, 01 Sep 2023 18:41:36 -0400 Received: by mail-ej1-f70.google.com with SMTP id a640c23a62f3a-9a5cd04315aso172426766b.2 for ; Fri, 01 Sep 2023 15:41:36 -0700 (PDT) Received: from carol.localdomain (cst-prg-234-228.cust.vodafone.cz. [46.135.234.228]) by smtp.gmail.com with ESMTPSA id j8-20020a170906830800b009a19701e7b5sm2569126ejx.96.2023.09.01.15.41.34 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 01 Sep 2023 15:41:34 -0700 (PDT) Received: from carol.home (carol.k8r.cz [127.0.0.1]) by carol.localdomain (Postfix) with ESMTP id D970FE09D431 for ; Sat, 2 Sep 2023 00:41:33 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1693608107; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=eCn9AyOH67f/AJEJuQQKE3J2U+c48WvkToFa+7Cxw7E=; b=VMx+ww8lVnc1cs18DCu842She8iL0p1Osrp+L/jzUbYOn94mVgPB5cLhQ5xmj/VjpqalPl 0k9Ih8tUxM3HY0tLw2inmRPDEvLRZU1f9UC1I36w5EyPOwKO1mntzsutCPSfPMWP23+G8T jEZ/mF1JIB8xr30zfd9o7ksUFJ/kq1s= X-MC-Unique: LgnR1Il8PqWFrO4RME2STw-1 X-Original-To: libvir-list@listman.corp.redhat.com X-MC-Unique: pi_QecNoOv-Twv9RHm5VcQ-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693608095; x=1694212895; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=eCn9AyOH67f/AJEJuQQKE3J2U+c48WvkToFa+7Cxw7E=; b=hql69K+7hCUTg3bA0HdHuKfXPv8g/yJ5cSeOXZjVQJ/8gw3tdm1rrqMGA/d6L7JseU oRfCw1M1o8T2blsbLB52QfIhz9h3P8pqJwQygDD/7uZJzbTfWvqGyQZW/nEPIr68c51j vK9PkoT4U/NZ5NqS8yyV60Xx68WZFstTjVD52KHBAdUrbjMcfe/pB16dceOnkH4w70fq EwaHA0UjDvkhfPBFFXFYXetcgBLgb5yyJb02XkGFqGNoqi3aPLaowNumhfStHGZHsK4I tFJEWE6wljsl/237gSqOVyqUuapJ4le8dXkFRtita4sbbCyzyy/pjYxU+FHmA7F+nTv1 IaIQ== X-Gm-Message-State: AOJu0YwTs020PXO/pN3EXeDYuWinoMhPOxR+PoXG4SaiSt5br2Ijn4VN 8FWgxE045Hqk2mmwtVrC8EasKq9GpILJYHVLjhtzJjfG55+IBV4Wa25U+HFN2vHqC03uMs/xx9x +8rt2YRPFPCArevVr0lzXI0mNUqAMeQlmBEQBPl/trIW+5nTRuleuq4L6f+T+qUJfioIDopDtNQ loUyM= X-Received: by 2002:a17:906:530c:b0:9a5:c3f9:c89d with SMTP id h12-20020a170906530c00b009a5c3f9c89dmr2847020ejo.24.1693608095488; Fri, 01 Sep 2023 15:41:35 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEOW+Rr/im9hWXHUpXmI5RM+ZgaSoEg5X77ApX9Jp+fUq0x64aWuZCL3+Qi4H+k06yqOtRe7Q== X-Received: by 2002:a17:906:530c:b0:9a5:c3f9:c89d with SMTP id h12-20020a170906530c00b009a5c3f9c89dmr2847011ejo.24.1693608095184; Fri, 01 Sep 2023 15:41:35 -0700 (PDT) From: Martin Kletzander To: libvir-list@redhat.com Subject: [PATCH] docs, passt: Clarify some niche passt usage Date: Sat, 2 Sep 2023 00:41:14 +0200 Message-ID: <891dd893133b51681ce69e0aedc6ed44745b18af.1693608074.git.mkletzan@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.7 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1693608111249100001 Content-Type: text/plain; charset="utf-8"; x-default="true" Change example logfile path and clarify how complicated all things passt are. I chose not to create the non-existing directory because it could open a whole new can of worms. Also explain missing `dev` attribute of `` Resolves: https://issues.redhat.com/browse/RHEL-1833 Signed-off-by: Martin Kletzander Reviewed-by: Michal Privoznik --- docs/formatdomain.rst | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 68f54ab3ed62..bc469e5f9f94 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4902,14 +4902,23 @@ When the passt backend is used, the ```` a= ttribute ``logFile`` can be used to tell the passt process for this interface where to write its message log, and the ```` attribute ``dev`` can tell it to use a particular host interface to derive the routes -given to the guest for forwarding traffic upstream. +given to the guest for forwarding traffic upstream. Due to the design +decisions of passt, if using SELinux, the log file is recommended to +reside in the runtime directory of a user under which the passt +process will run, most probably ``/run/user/$UID`` where ``$UID`` is +the UID of the user, e.g. ``qemu``. Beware that libvirt does not +create this directory if it does not already exist to avoid possible, +however unlikely, issues, especially since this logfile attribute is +meant mostly for debugging. =20 Additionally, when passt is used, multiple ```` elements can be added to forward incoming network traffic for the host to this guest interface. Each ```` must have a ``proto`` -attribute (set to ``tcp`` or ``udp``) and optional original -``address`` (if not specified, then all incoming sessions to any host -IP for the given proto/port(s) will be forwarded to the guest). +attribute (set to ``tcp`` or ``udp``), optional original ``address`` +(if not specified, then all incoming sessions to any host IP for the +given proto/port(s) will be forwarded to the guest), and an optional +``dev`` attribute to limit the forwarded traffic to a specific host +interface. =20 The decision of which ports to forward is described with zero or more ```` subelements of ```` (if there is no @@ -4934,7 +4943,7 @@ ports **with the exception of some subset**. ... - + @@ -4946,7 +4955,7 @@ ports **with the exception of some subset**. - + --=20 2.41.0