From b735f287959383b7f331bc6e8d341db34d730c7d Mon Sep 17 00:00:00 2001 From: Thomas Naughton Date: Fri, 13 Jan 2023 21:27:15 -0500 Subject: [PATCH] errata: fix broken links in spec v3 refs #378 Signed-off-by: Thomas Naughton --- Chap_API_Key_Value_Mgmt.tex | 5 +++-- Chap_Introduction.tex | 6 +++--- pmix-standard.bib | 8 ++++---- 3 files changed, 10 insertions(+), 9 deletions(-) diff --git a/Chap_API_Key_Value_Mgmt.tex b/Chap_API_Key_Value_Mgmt.tex index d356def9..5f8ecb8e 100644 --- a/Chap_API_Key_Value_Mgmt.tex +++ b/Chap_API_Key_Value_Mgmt.tex @@ -136,7 +136,8 @@ \subsection{\code{PMIx_Get}} The \refarg{info} array is used to pass user requests regarding the get operation. \adviceuserstart -Information provided by the \ac{PMIx} server at time of process start is accessed by providing the namespace of the job with the rank set to \refconst{PMIX_RANK_WILDCARD}. The list of data referenced in this way is maintained on the \ac{PMIx} web site at \url{https://pmix.org/support/faq/wildcard-rank-access/} but includes items such as the number of processes in the namespace (\refattr{PMIX_JOB_SIZE}), total available slots in the allocation (\refattr{PMIX_UNIV_SIZE}), and the number of nodes in the allocation (\refattr{PMIX_NUM_NODES}). +Information provided by the \ac{PMIx} server at time of process start is accessed by providing the namespace of the job with the rank set to \refconst{PMIX_RANK_WILDCARD}. Attributes referenced in this way are identified in \ref{api:struct:attributes} but includes items such as the number of processes in the namespace (\refattr{PMIX_JOB_SIZE}), total available slots in the allocation (\refattr{PMIX_UNIV_SIZE}), and the number of nodes in the allocation (\refattr{PMIX_NUM_NODES}). + Data posted by a process via \refapi{PMIx_Put} needs to be retrieved by specifying the rank of the posting process. All other information is retrievable using a rank of \refconst{PMIX_RANK_WILDCARD} when the information being retrieved refers to something non-rank specific (e.g., number of processes on a node, number of processes in a job), and using the rank of the relevant process when requesting information that is rank-specific (e.g., the \ac{URI} of the process, or the node upon which it is executing). Each subsection of Section \ref{api:struct:attributes} indicates the appropriate rank value for referencing the defined attribute. \adviceuserend @@ -219,7 +220,7 @@ \subsection{\code{PMIx_Get_nb}} The \argref{info} array is used as described by the \refapi{PMIx_Get} routine. \adviceuserstart -Information provided by the \ac{PMIx} server at time of process start is accessed by providing the namespace of the job with the rank set to \refconst{PMIX_RANK_WILDCARD}. Attributes referenced in this way are identified in \ref{api:struct:attributes} but includes items such as the number of processes in the namespace (\refattr{PMIX_JOB_SIZE}), total available slots in the allocation (\refattr{PMIX_UNIV_SIZE}), and the number of nodes in the allocation (\refattr{PMIX_NUM_NODES}). +Information provided by the \ac{PMIx} server at time of process start is accessed by providing the namespace of the job with the rank set to \refconst{PMIX_RANK_WILDCARD}. Attributes referenced in this way are identified in \ref{api:struct:attributes} but includes items such as the number of processes in the namespace (\refattr{PMIX_JOB_SIZE}), total available slots in the allocation (\refattr{PMIX_UNIV_SIZE}), and the number of nodes in the allocation (\refattr{PMIX_NUM_NODES}). In general, data posted by a process via \refapi{PMIx_Put} and data that refers directly to a process-related value needs to be retrieved by specifying the rank of the posting process. All other information is retrievable using a rank of \refconst{PMIX_RANK_WILDCARD}, as illustrated in \ref{chap:api_kv:getex}. See \ref{api:struct:attributes:retrieval} for an explanation regarding use of the \emph{level} attributes. \adviceuserend diff --git a/Chap_Introduction.tex b/Chap_Introduction.tex index f72885a2..976f617a 100644 --- a/Chap_Introduction.tex +++ b/Chap_Introduction.tex @@ -186,14 +186,14 @@ \subsection{The \acf{PRI}} \item Ease of adoption.\\ The \ac{PRI} is designed to be particularly easy for resource managers (and the \ac{SMS} in general) to adopt, thus facilitating a rapid uptake into that community for application portability. Both client and server \ac{PMIx} libraries are included, along with examples of client usage and server-side integration. -A list of supported environments and versions is maintained on the \ac{PMIx} web site \url{https://pmix.org/support/faq/what-apis-are-supported-on-my-rm/} +A list of supported environments and versions is maintained on the OpenPMIx web site \url{https://openpmix.org} \end{itemize} The \ac{PRI} does provide some internal implementations that lie outside the scope of the \ac{PMIx} standard. This includes several convenience macros as well as support for consolidating collectives for optimization purposes (e.g., the \ac{PMIx} server aggregates all local \refapi{PMIx_Fence} calls before passing them to the \ac{SMS} for global execution). In a few additional cases, the \ac{PMIx} community (in partnership with the \ac{SMS} subsystem providers) have determined that a base level of support for a given operation can best be portably provided by including it in the \ac{PRI}. Instructions for downloading, and installing the \ac{PRI} are available -on the community's web site \url{https://pmix.org/code/getting-the-reference-implementation/}.The \ac{PRI} targets support for the Linux operating system. +on the OpenPMIx web site \url{https://openpmix.org}. The \ac{PRI} targets support for the Linux operating system. A reasonable effort is made to support all major, modern Linux distributions; however, validation is limited to the most recent 2-3 releases of RedHat Enterprise Linux (RHEL), Fedora, CentOS, and SUSE Linux Enterprise Server (SLES). In addition, development support is maintained for Mac OSX. Production support for vendor-specific operating systems is included as provided by the vendor. @@ -207,7 +207,7 @@ \subsection{The PMIx Reference RunTime Environment (PRRTE)} provides an easy way of exploring \ac{PMIx} capabilities and testing PMIx-based applications outside of a PMIx-enabled environment by providing a ``shim'' between the application and the host environment that includes full support for the \ac{PRI}. The intent of \ac{PRRTE} is not to replace any existing production environment, but rather to enable developers to work on systems that do not yet feature a PMIx-enabled host \ac{SMS} or one that lacks a \ac{PMIx} feature of interest. Instructions for downloading, installing, and using \ac{PRRTE} are available -on the community's web site \url{https://pmix.org/code/getting-the-pmix-reference-server/} +on the OpenPMIx web site \url{https://openpmix.org} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{Organization of this document} diff --git a/pmix-standard.bib b/pmix-standard.bib index 6d7cf3b6..7d575279 100644 --- a/pmix-standard.bib +++ b/pmix-standard.bib @@ -31,15 +31,15 @@ @inproceedings{2017-Castain-EuroMPI @misc{event1, Author = {R. H. Castain}, - Howpublished = {\url{https://pmix.org/pmix-standard/event-notification/}}, - Note = {[Online; accessed 03-Nov-2017]}, + Howpublished = {\url{https://pmix.org/standard/RFC/event-notification/}}, + Note = {[Online; accessed 13-Jan-2023]}, Title = {{RFC0002: PMIx Event Notification}}, Year = {2016}} @misc{event2, Author = {R. H. Castain}, - Howpublished = {\url{https://pmix.org/pmix-standard/extend-event-notification/}}, - Note = {[Online; accessed 03-Nov-2017]}, + Howpublished = {\url{https://pmix.org/standard/RFC/extend-event-notification/}}, + Note = {[Online; accessed 13-Jan-2023]}, Title = {{RFC0018: Extend the Event Notification RFC}}, Year = {2017}}