From nobody Fri Feb 21 16:46:29 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Yzwxx5Rrsz5nvck for ; Fri, 21 Feb 2025 16:46:29 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Yzwxx4k76z3phW; Fri, 21 Feb 2025 16:46:29 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1740156389; h=from:from: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; bh=UU111HvJAMiZwaW067Y4CKyVBWDy0BkOOZSpcZOExb8=; b=vKqjKp82pJsnPdi2I2M2zQd/9WvZUda4i0TCtybzCnTtlQpS0tKoBr81MPrInbLgYTCiqM b6hNnUb33T+ziV9TdiF0WRrTQcbqtvBITaPj5ZawJljTsNePJ2VSQ5RjJm+/BCwC9ERjlB v8vpj8tmxk8bgazSyoz1psR/+HREnyREC9N4z9A3SedrgG9ZbxS/paexjQd6Aw8thhWbL1 OreuggnxPPTHRoWQyeMN1p3f94IoibTb2Jl8xaFf64vmal/mnBvYAtKH0MifIZDy4YQ3mA SEs2EKoLUcrS/jPuJqcE44B2lHuuRpIvpkPoS06hd6Vh5YRs1wGxxukl5snHNg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1740156389; a=rsa-sha256; cv=none; b=GogZi2dHWC0TIaMYnFLwkQq8VACujB2NZppZWNIRjACpvRfKJuFVmRUEH3HXax5XAqcbJy /W5vNmFpGLNl2++8d13Ak9drjCAxYEtWeBc04ILoPGN5fGoxMkzy0cNUbQmSP0TQ+/sQhK +n29SUdTLkobv1vvem7A6VKMYZ7ANjIE5YtafdfCtKCPqnuTwkv4DP2QchKuAvEBveTIys sW6NeI+/noGepfb0ho6VQIz7PzZladONis6abyIpZC4DYCvU5GO017xqm+oOKLUISM/Ykd 4Bu61+YkN/b0zEVzFhID1A+pArJpGSAHlQf9pP/WvTKxwhm0zn0tDnBKVMhQPw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1740156389; h=from:from: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; bh=UU111HvJAMiZwaW067Y4CKyVBWDy0BkOOZSpcZOExb8=; b=ChnW+3qyV/4OaApPbMaRNqipZm58mn5F1EvZlVrojCAbcho4m2TAjB540bQi7q42LSnxxL ZSy8hXzjsf8s6NGhglGVVgX06NmsQ0E3BJ9gmJy6uakTOLPNy7VbQZBLgCehr8sw2Vbk2c ElVgNzdiB77lBkO8yb8LGRa5yG/5rf+3nCnMaGJpJaHGahgro4HS908dDennYIWmkl7WFE LBGJCeQehGG+3UlB4RaNX3XbhKU5t9W6KeyPsFp1AlXGEDoLYx/MgOMmy2jLjbGg1K1QXD OjonkKNDIT99NrIVlGVIUVwh4OXRkEnDBPfFKW2E9nM0BUgiMt1M8fN6t5eF/g== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Yzwxx3grPzVYd; Fri, 21 Feb 2025 16:46:29 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 51LGkTXg033866; Fri, 21 Feb 2025 16:46:29 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 51LGkTvL033863; Fri, 21 Feb 2025 16:46:29 GMT (envelope-from git) Date: Fri, 21 Feb 2025 16:46:29 GMT Message-Id: <202502211646.51LGkTvL033863@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Fernando =?utf-8?Q?Apestegu=C3=ADa?= Subject: git: 0bb186d842 - main - [phb]: Add missing Uses=ansible List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0bb186d842fb03a626cc540fe56ca6c9b73bebbb Auto-Submitted: auto-generated The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=0bb186d842fb03a626cc540fe56ca6c9b73bebbb commit 0bb186d842fb03a626cc540fe56ca6c9b73bebbb Author: Fernando Apesteguía AuthorDate: 2025-02-07 18:45:32 +0000 Commit: Fernando Apesteguía CommitDate: 2025-02-21 16:46:11 +0000 [phb]: Add missing Uses=ansible --- .../en/books/porters-handbook/uses/_index.adoc | 42 ++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index a174d5a48f..4a3facc28f 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -139,6 +139,48 @@ The tagname of the `angr` binaries. `ANGR_NOSETESTS`:: The path to the `nosetests` program. +[[uses-ansible]] +== `ansible` + +Possible arguments: `env`, `module`, `plugin` + +Provide support for ports depending on package:sysutils/ansible[]. + +If the `env` argument is present, the port does not depend on +package:sysutils/ansible[] but needs some Ansible variables set. + +If the `module` argument is present then the port is an Ansible module. + +If the `plugin` argument is present then the port is an Ansible plugin. + +The framework exposes the following variables to the port: + +`ANSIBLE_CMD`:: +Path to the ansible program. + +`ANSIBLE_DOC_CMD`:: +Path to the ansible-doc program. + +`ANSIBLE_RUN_DEPENDS`:: +RUN_DEPENDS with the Ansible port. + +`ANSIBLE_DATADIR`:: +Path to the root of the directory structure where all Ansible's modules and plugins are stored. + +`ANSIBLE_ETCDIR`:: +Path to the Ansible etc directory. + +`ANSIBLE_PLUGINS_PREFIX`:: +Path to the "plugins" directory within `${ANSIBLE_DATADIR}`. +`ANSIBLE_MODULESDIR`:: +Path to the directory for local Ansible modules. + +`ANSIBLE_PLUGINSDIR`:: +Path to the directory for local Ansible plugins. + +`ANSIBLE_PLUGIN_TYPE`:: +Ansible plugin type (e.g., "connection", "inventory", or "vars"). + [[uses-autoreconf]] == `autoreconf`