From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from tb-mx0.topicbox.com (localhost.local [127.0.0.1]) by tb-mx0.topicbox.com (Postfix) with ESMTP id 08E5725C9F98 for ; Thu, 12 Sep 2024 00:20:55 -0400 (EDT) (envelope-from william@welliver.org) Received: from tb-mx0.topicbox.com (localhost [127.0.0.1]) by tb-mx0.topicbox.com (Authentication Milter) with ESMTP id 10CD8EB51F1; Thu, 12 Sep 2024 00:20:55 -0400 ARC-Seal: i=1; a=rsa-sha256; cv=none; d=topicbox.com; s=arcseal; t= 1726114854; b=dPHBrRZ1fIeamfc4nVWOWyHcZjHWuenzZto5edXVDcOhrimqtw CZ8dnYomOqcXuiVQGcImomnyhjN+nU2iC4fvc4vRfC7lt+qsbKDlqdVodB786noX IPWAJG6cCeWV5JQUIP98Eb0Ok+Olkruy4ajutlFFpNdY9P6IxpmTJcNPSeJVrtpW iEAgkfzUkJdm18R42bHgeKr+HorVlG017+NlV+ppP4j3c/KF2LueOitXVe5rzMQ4 2P3MTTOg2f99e85+q0mTGR5yp5E/q/bMgqfRRM6bOMCWlfT9SPJQjSTS9HWiXRSi ztMoDz3T0MOVCgasqWap+ZOYHJm88YnBB8ew== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d= topicbox.com; h=from:content-type:content-transfer-encoding :mime-version:subject:date:references:to:in-reply-to:message-id; s=arcseal; t=1726114854; bh=QsfFCzFLXRWfRj8QH9f5s2hAV7so89uQrzW v/capOx4=; b=nWhlUR14mMT/iv7p3xro7lOEpYVaEUl0D0WfZmeUh6bHa+vmRbZ maxQvaiTWeJq95Y9UAzSqGs5T950dw8rSbj7rDgXoiPyyMb2FsgPo5ZNJ5UHUDZR 9L0ioZEL6jfu8ZCipYrB2nQOyrHxjvk9wrGwl5HwC6NFYkRppoJc9NSgXxi0EvlX eua+eKwfcxJleKKVX49dxwymFoMpIysIxoWnCUUdqi0Le7Z3XDur39319MK8hhNU Dux9WqOylr5eaO/tEpKQ3xo88JMOXu69gdXRSN3mK+IS1QqCv1xcINKnGw3bqfWx DaSOqgYf2J+Kf0g95/7Hc+OXpSpEQKbV6Xw== ARC-Authentication-Results: i=1; tb-mx0.topicbox.com; arc=none (no signatures found); bimi=skipped (DMARC Policy is not at enforcement); dkim=pass (2048-bit rsa key sha256) header.d=welliver.org header.i=@welliver.org header.b=lpdtlauv header.a=rsa-sha256 header.s=s20190714337 x-bits=2048; dmarc=pass policy.published-domain-policy=none policy.applied-disposition=none policy.evaluated-disposition=none (p=none,d=none,d.eval=none) policy.policy-from=p header.from=welliver.org; iprev=pass smtp.remote-ip=192.99.78.184 (smtp.welliver.org); spf=pass smtp.mailfrom=william@welliver.org smtp.helo=smtp.welliver.org; x-aligned-from=pass (Address match); x-me-sender=none; x-ptr=pass smtp.helo=smtp.welliver.org policy.ptr=smtp.welliver.org; x-return-mx=pass header.domain=welliver.org policy.is_org=yes (MX Records found: smtp.welliver.org); x-return-mx=pass smtp.domain=welliver.org policy.is_org=yes (MX Records found: smtp.welliver.org); x-tls=pass smtp.version=TLSv1.2 smtp.cipher=ECDHE-RSA-AES256-GCM-SHA384 smtp.bits=256/256; x-vs=clean score=-100 state=0 Authentication-Results: tb-mx0.topicbox.com; arc=none (no signatures found); bimi=skipped (DMARC Policy is not at enforcement); dkim=pass (2048-bit rsa key sha256) header.d=welliver.org header.i=@welliver.org header.b=lpdtlauv header.a=rsa-sha256 header.s=s20190714337 x-bits=2048; dmarc=pass policy.published-domain-policy=none policy.applied-disposition=none policy.evaluated-disposition=none (p=none,d=none,d.eval=none) policy.policy-from=p header.from=welliver.org; iprev=pass smtp.remote-ip=192.99.78.184 (smtp.welliver.org); spf=pass smtp.mailfrom=william@welliver.org smtp.helo=smtp.welliver.org; x-aligned-from=pass (Address match); x-me-sender=none; x-ptr=pass smtp.helo=smtp.welliver.org policy.ptr=smtp.welliver.org; x-return-mx=pass header.domain=welliver.org policy.is_org=yes (MX Records found: smtp.welliver.org); x-return-mx=pass smtp.domain=welliver.org policy.is_org=yes (MX Records found: smtp.welliver.org); x-tls=pass smtp.version=TLSv1.2 smtp.cipher=ECDHE-RSA-AES256-GCM-SHA384 smtp.bits=256/256; x-vs=clean score=-100 state=0 X-ME-VSCause: gggruggvucftvghtrhhoucdtuddrgeeftddrudejvddgkeefucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggvpdfu rfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnh htshculddquddttddmnecujfgurhephfgtgfgguffffhfvjgfkofesthhqmhdthhdtjeen ucfhrhhomhepfdfjrdcuhghilhhlihgrmhcuhggvlhhlihhvvghrfdcuoeifihhllhhirg hmseifvghllhhivhgvrhdrohhrgheqnecuggftrfgrthhtvghrnhepjeduhedvhfffjeel heeuueejveeikeffteelfeevudfhgeeitedtveegtefgvdfhnecukfhppeduledvrdelle drjeekrddukeegnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthep udelvddrleelrdejkedrudekgedphhgvlhhopehsmhhtphdrfigvlhhlihhvvghrrdhorh hgpdhmrghilhhfrhhomhepoeifihhllhhirghmseifvghllhhivhgvrhdrohhrgheqpdhn sggprhgtphhtthhopedupdhrtghpthhtohepoeguvghvvghlohhpvghrsehlihhsthhsrd hilhhluhhmohhsrdhorhhgqe X-ME-VSScore: -100 X-ME-VSCategory: clean Received-SPF: pass (welliver.org: 192.99.78.184 is authorized to use 'william@welliver.org' in 'mfrom' identity (mechanism 'mx' matched)) receiver=tb-mx0.topicbox.com; identity=mailfrom; envelope-from="william@welliver.org"; helo=smtp.welliver.org; client-ip=192.99.78.184 Received: from smtp.welliver.org (smtp.welliver.org [192.99.78.184]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by tb-mx0.topicbox.com (Postfix) with ESMTPS for ; Thu, 12 Sep 2024 00:20:54 -0400 (EDT) (envelope-from william@welliver.org) Authentication-Results: smtp.welliver.org; auth=pass (plain) From: "H. William Welliver" Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.2\)) Subject: Re: [developer] [REVIEW] 16763: dladm simnet functionality should be documented Date: Thu, 12 Sep 2024 00:20:52 -0400 References: <22C789E4-5811-43E0-A48D-B361F75A7CF0@eenfach.de> To: illumos-developer In-Reply-To: <22C789E4-5811-43E0-A48D-B361F75A7CF0@eenfach.de> Message-Id: <862F4DFB-01AF-4639-BA61-8A87BC5060B6@welliver.org> X-Mailer: Apple Mail (2.3696.120.41.1.2) Received: from localhost (Unknown [127.0.0.1]) by smtp.welliver.org (Haraka/3.0.1) with ESMTPSA id 9448C29E-C801-47A8-BEC6-42F8BCA3613B.1 envelope-from tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (authenticated bits=0); Thu, 12 Sep 2024 04:20:53 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=welliver.org; s=s20190714337; h=from:subject:date:message-id:to:mime-version; bh=QsfFCzFLXRWfRj8QH9f5s2hAV7so89uQrzWv/capOx4=; b=lpdtlauvot70En7dimiTzeE8a2vN2U9aBdOCR7wxHz7RX7bKXDqnZZ5ihYabf6dNY8pLSnhNPe 0W06pqpq68e5UGb3RBW2/GoJatNk6UHzpt4sKIa/NXyhIsGwxzqwjWyP86blAgXIdMnrjyGXzq5U JN1l1MSovY3vPmOtt4SIYJxHIknSkk/FcIuakVrpswkhJL9cj56RnabeHLvWQs0jcmT8EWQYTbA+ AWGFVoP7pEDPhfAC4S1ZO0zZmj2pIpzgRHX7UaV9W/+Ku5Qvd0IpmWzXGBJkb1gB9rhO3kPy0E8Z GsSI/xkFTPnpiwihJ0tgts1KB1dr1Ib2z/i/1jjw== Topicbox-Policy-Reasoning: allow: sender is a member Topicbox-Message-UUID: 69ae0d60-70be-11ef-b929-a8db068c7b06 Hi! I did add a brief description of what simnets are in the = =E2=80=9CDescription=E2=80=9D section, as that is where other types of = objects (vnics, etherstubs, etc) are introduced. I=E2=80=99ll also = willingly admit that I don=E2=80=99t normally read that section and jump = right to the command details but I was trying to remain consistent with = the existing document. As a side-note: I didn=E2=80=99t specifically describe simnets as a = debugging facility because I think they can be handy for other things, = as well. I first (mis)used them by adding one to a bridge created from = the physical nics on the device. I then configured the other end as the = host=E2=80=99s primary interface. This enabled the host to be accessible = without a particular port needing to be physically =E2=80=9Cup=E2=80=9D. = Strange and very niche, but pretty handy for making network appliances. Bill > On Sep 11, 2024, at 2:48 PM, Olaf Bohlen wrote: >=20 > Dear William, >=20 > maybe the create-simnet subcommand should include a very brief = explanation what =E2=80=9Csimnet=E2=80=9D actually is. So that end users = understand that it is mostly a debugging facility. >=20 > Regards, >=20 > Olaf Bohlen > olbohlen@eenfach.de