From e089652c0dc81732a16e84762bf733ad60fa02eb Mon Sep 17 00:00:00 2001 From: Toshaan Bharvani Date: Thu, 17 Jun 2021 21:13:31 +0200 Subject: [PATCH] intial hub charter, as of my notes Signed-off-by: Toshaan Bharvani --- .gitignore | 3 + Makefile | 33 +++++++ appendices.tex | 0 charter.tex | 125 ++++++++++++++++++++++++++ content.tex | 232 +++++++++++++++++++++++++++++++++++++++++++++++++ glossaries.tex | 11 +++ opf-logo.png | Bin 0 -> 5073 bytes 7 files changed, 404 insertions(+) create mode 100644 .gitignore create mode 100755 Makefile create mode 100644 appendices.tex create mode 100755 charter.tex create mode 100644 content.tex create mode 100644 glossaries.tex create mode 100644 opf-logo.png diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..067cf4d --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +#!.gitignore +*.pdf +version diff --git a/Makefile b/Makefile new file mode 100755 index 0000000..de23d2f --- /dev/null +++ b/Makefile @@ -0,0 +1,33 @@ +#!Makefile + +default all: pdf + +TEXFILE=charter + +TMPDIR:=$(shell mktemp -d /tmp/latex.XXXX) +FIRSTTAG:=$(shell git describe --abbrev=0 --tags --always) +RELTAG:=$(shell git describe --tags --long --always --dirty='-*' --match '[0-9]*.*') + +pdf: gitinfo tex + +.PHONY: gitinfo +gitinfo: + @git --no-pager log -1 --date=short --decorate=short --pretty=format:"\usepackage[shash={%h},lhash={%H},authname={%an},authemail={%ae},authsdate={%ad},authidate={%ai},authudate={%at},commname={%an},commemail={%ae},commsdate={%ad},commidate={%ai},commudate={%at},refnames={%d},firsttagdescribe="${FIRSTTAG}",reltag="${RELTAG}"]{gitexinfo}" HEAD > $(TMPDIR)/gitHeadLocal.gin + +tex: $(TEXFILE).tex + @test -d $(TMPDIR) || mkdir $(TMPDIR) + @echo "Running 2 compiles $(TMPDIR)" + @pdflatex -output-directory=$(TMPDIR) -interaction=batchmode -file-line-error -no-shell-escape $< > /dev/null + @makeglossaries -d $(TMPDIR) $(TEXFILE) + @pdflatex -output-directory=$(TMPDIR) -interaction=batchmode -file-line-error -no-shell-escape $< > /dev/null + @cp $(TMPDIR)/$(TEXFILE).pdf . + @echo $(FIRSTTAG) > version + @echo "$(TEXFILE) PDF Ready" + +.PHONY: clean +clean: + @rm -rf /tmp/latex.* + +cleanall: + @rm -rf /tmp/latex.* + @rm -f $(TEXFILE).pdf diff --git a/appendices.tex b/appendices.tex new file mode 100644 index 0000000..e69de29 diff --git a/charter.tex b/charter.tex new file mode 100755 index 0000000..7c2a172 --- /dev/null +++ b/charter.tex @@ -0,0 +1,125 @@ +\documentclass[a4paper,12pt]{report} + +% packeges +\usepackage[a4paper]{geometry} +\usepackage{fancyhdr} +\usepackage{lastpage} +%\usepackage{amsmath} +%\usepackage{amssymb} +%\usepackage{amsthm} +%\usepackage{array} +%\usepackage{xy} +\usepackage{longtable} +\usepackage{multirow} +\usepackage{setspace} +\usepackage{graphicx} +\usepackage{url} +\usepackage{hyperref} +\usepackage{color} +\usepackage{etex} +\usepackage[local]{gitinfo2} +\usepackage{titlesec} +%\usepackage{draftwatermark} +\usepackage[acronym,ucmark,nomain]{glossaries} +%\usepackage[curly,sort,comma,numbers]{natbib} + +%compression +\pdfminorversion=7 +\pdfcompresslevel=9 +\pdfobjcompresslevel=2 + +\hypersetup{ + %hyperindex=true, + %hyperfigures=true, + %pagebackref=true, + %backref, + colorlinks=true, + linkcolor=black, + anchorcolor=black, + citecolor=black, + filecolor=black, + menucolor=black, + pagecolor=black, + urlcolor=black, + %bookmarksnumbered, + %pdfborder=0 0 0,' + pdftoolbar=false, + pdfmenubar=false, + %bookmarks=false, + pdfproducer={OPF Template Generator}, + pdfcreator={OPF POWER ISA TWG}, + pdfauthor={Toshaan Bharvani }, + pdftitle={OpenPOWER Foundation ISA TWG Charter}, + pdfsubject={OpenPOWER Foundation ISA TWG Charter}, + pdfkeywords={OPF,OpenPOWER,POWER ISA,ISA,charter} +} + +% page layout +\geometry{top=30mm} +\geometry{bottom=20mm} +\geometry{left=20mm} +\geometry{right=20mm} +\geometry{headheight=25mm} +\geometry{headsep=10mm} +\geometry{foot=10mm} + +%\renewcommand{\partname}{} +%\renewcommand{\thechapter}{\arabic{chapter}} +%\renewcommand{\thepart}{\arabic{part}.} +\renewcommand{\thesection}{\arabic{section}.} +\renewcommand{\thesubsection}{\thesection\arabic{subsection}.} +\renewcommand{\thesubsubsection}{\thesection\thesubsection\arabic{subsubsection}} + +%\SetWatermarkText{Draft} +%\SetWatermarkScale{10} + +\input{glossaries.tex} + +% real begining +\begin{document} + +\pagenumbering{arabic} +\setcounter{page}{1} + +%\renewcommand{\baselinestretch}{2} +%\doublespacing +\setlength{\parindent}{0em} +\setlength{\parskip}{0em} + +\pagestyle{fancy} +\renewcommand{\headrulewidth}{2pt} +\renewcommand{\footrulewidth}{2pt} + +% fancyhdr +\fancyhead{} +\fancyhead[L]{ + \includegraphics[width=4cm]{opf-logo.png} +} +\fancyhead[R]{ + OpenPOWER Foundation Workgroup Charter +} + +\fancyfoot{} +\fancyfoot[L]{ + \begin{tiny} + OPF Workgroup Charter + \end{tiny} +} +\fancyfoot[C]{ + \begin{tiny} + \gitFirstTagDescribe{} (\gitAbbrevHash{} - \gitAuthorDate{}) + \end{tiny} +} +\fancyfoot[R]{ + \begin{tiny} + \thepage\ of \pageref{LastPage} + \end{tiny} +} + +%%% +\input{content.tex} +\input{appendices.tex} + +\printglossary[type=\acronymtype,title=List of Acronyms] + +\end{document} diff --git a/content.tex b/content.tex new file mode 100644 index 0000000..e6dce0b --- /dev/null +++ b/content.tex @@ -0,0 +1,232 @@ +%%% + +\section{Workgroup name} + +HUB \acrfull{STIG} + +\section{Definitions} + +Reference the OpenPOWER Foundation \acrshort{IPR} Policy and OpenPOWER WorkGroup Process for additional term definitions. + +\begin{enumerate} +\item +``Provider" is an Eligible participant of the workgroup that has been elected by Full Majority Vote to provide OpenPOWER resources +to the Open Source community for the purpose of enabling, promoting, converting, porting, and testing open source on OpenPOWER. +\item +``" +\end{enumerate} + +\section{Description} + +The HUB \acrshort{STIG} is a workgroup whose purpose is to enable the process of porting to OpenPOWER, +this \acrshort{STIG} will enable the porting, conversion, and testing of open source on OpenPOWER. +This \acrshort{STIG} will provide resources for these efforts by levering Providers to enable open source to gain access to +OpenPOWER resources for the purpose of porting, converting, and maintaining open source resources to be enabled on OpenPOWER.\par + +The HUB \acrshort{STIG} will create processes, documentation, code and how-to guides to assist in OpenPOWER enablement. +In addition to these documents, the HUB \acrshort{STIG} will provide resources that enable the porting, conversion and maintance +throught Providers that have resources available to assist open source in this effort.\par + +The purpose of the HUB is to be a central place where a public open source project can reach out to for help. +It is up to the HUB to assist these projects in their endavour to OpenPOWER.\par + +\section{Scope} + +The scope of the HUB \acrshort{STIG} is the creation of a central place for OpenPOWER porting. +The \acrshort{STIG} will do this by providing documentation, code, and resources to enable the porting, converting, and maintaining +of open source on OpenPOWER.\par + +The HUB \acrshort{STIG} will create documentation on how to enable open source on OpenPOWER. +It will do this in a way to enable all features, and options available on OpenPOWER. +This documentataion will be made publically available and be distributed within several open source communities.\par + +In addition to the documentation, the HUB \acrshort{STIG} will work with Providers to make resources, such as but not limited to +\begin{itemize} +\item +Cloud Server Hardware +\item +FPGA based Hardware +\item +GPU based Hardware +\item +Specialized hardware +\item +Software distributions +\end{itemize} +\par + +In addition the HUB \acrshort{STIG} will be a workgroup that evangalises the adoption of OpenPOWER +through technical documentation and resource availability.\par + +\section{Similar Activities} + +\begin{itemize} +\item +Accelerator Workgroup : may work with to define the requirements for open tooling needed to complete the implementation of OpenPOWER +\item +Memory Workgroup : defines the requirements for OpenPOWER Memory adoption, such as OMI +\item +HW Architecture Workgroup : maintains the hardware architecture specifications that may be needed for new development +\item +System Software Workgroup : owns definition, documentation, and maintenance of the firmware, Linux and other software on OpenPOWER +\item +Development Platform Workgroup : defines the reference architecture of future OpenPower systems +\end{itemize} + +\section{Users} + +Any open source project that plans to run on OpenPOWER. + +\section{Work Product} + +\begin{itemize} +\item +Documentation for adoption of, porting to, converting to OpenPOWER +\item +Code, such as patches for OpenPOWER, to be pushed to the upstream project +\item +Ensure maintaining open source enablement of OpenPOWER +\end{itemize} + +\section{Projects} + +\begin{itemize} +\item +Build documentation on adoption of, porting to, converting to OpenPOWER +\item +Assist in code patching of open source to OpenPOWER +\item +Assist in maintenance of open source on OpenPOWER +\item +Provide resources for open source to OpenPOWER +\end{itemize} + +\section{Participation} + +Public\par + +Participation and voting right requirements are as outlined per the OpenPOWER Work Group Process.\par + +A minimum of two Eligeble Participant will be required to be a Providers. +Providerss will have the responsibility to make resources available for open source to consume for the purpose of +porting, adopting, maintaining, or enhancing OpenPOWER.\par + +\section{Work Group Convener} + +Lance Albertson (OSU) - Toshaan Bharvani (VanTosh) + +\section{Meeting Plan} + +Lance will convene the first meeting.\par + +The first meeting will be at 18:00 CET on the second Thursday after the TSC and BoD approve the formation of the SIG. +Subsequent meetings will be held bi-weekly alternating between 18:00 CET Thursday and 00:00 CET Tuesday to accommodate participants in all time zones. + +\section{Participants} + +\begin{itemize} +\item +Oregon State University + \begin{itemize} + \item + Lance Albertson () + \end{itemize} +\item +Raptor Computing Systems + \begin{itemize} + \item + Timothy Pearson (tpearson@raptorengineering.com) + \end{itemize} +\item +VanTosh + \begin{itemize} + \item + Toshaan Bharvani (toshaan@vantosh.com) + \end{itemize} +\item +IBM + \begin{itemize} + \item + Paul Lecocq (lecocq@us.ibm.com) + \end{itemize} +\item +Yadro + \begin{itemize} + \item + Alexey Stepanov (a.stepanov@yadro.com) + \end{itemize} +\end{itemize} + +\section{Balloting Approval Requirements} + +Standard WG Process applies with the following specific requirements with respect to Providers : +\begin{itemize} +\item +Election of Providers will be by Full Majority Vote. +A Provider can be removed from their position as Provider by Full Majority Vote as well. +\item +The initial Providers will be voted in the first meeting. +\end{itemize} + +\section{Member Organization Support} + +Member organization support will be confirmed as part of the approval process. + +\section{Anticipated Contributions} + +none + +\section{IPR, Confidentiality \& Licensing} + +The following sections may not be modified after chartering. Changes require closing and submitting a new charter. + +\subsection{Confidentiality Mode} + +Non-confidential + +\subsection{IPR Policy} + +Code Mode + +\subsection{Open Source Licensing Mode} + +Apache License, v2.0\par + +All Code contributed to the WG by a WG Member or WG Party shall be licensed to OpenPOWER under Apache License, V2.0 +with the condition that the patent license granted in Section 3 of the License, as applied to the ``Work", hereby +includes implementations of the Work in physical form.\par + +Code contributed to the WG by a WG member or WG party may be licensed to OpenPOWER under a future open hardware license with +WG, TSC, and Board approval.\par + +All contributions to the WG's git repository must include a developer certificate of originality. +Non-Eligible person contributions to the git repository are bound to a Guest Participation Agreement. +The Guest Participation Agreement for this WG is agreement to the terms of the OS license as defined in the OS Licensing Mode and +documented in the license file within the WG's git repository.\par + +The Guest Participation Agreement is agreed to automatically upon any contribution to the WG's git repository. +Any contributions made outside the WG's git repository by a non-Eligible person must include a signed +Contribution / Feedback License as defined in Section 7.1 and Appendix A of the OpenPOWER IPR Policy. +Alternatively this WG can provide a Guest Participation Agreement to be signed per Section 7.2.\par + +The executed Contribution / Feedback License or Guest Participation Agreement must be sent to hub@openpower.foundation.\par + +As a default position, all Code that is, or is made part of, an OpenPOWER Deliverable shall be licensed out by OpenPOWER under one of the following +licenses and shall at least be provided in source code form. +The selected license will include or be accompanied by a clarification that any necessary license rights for the POWER \acrshort{ISA} comes from +the POWER \acrshort{ISA} license and is not granted under the selected license for the OpenPOWER Deliverable. +\begin{itemize} +\item +Apache License, V2.0 with the condition that the patent license granted in Section 3 of the License, as applied to the ``Work", +hereby includes implementations of the Work in physical form. +\item +a future open hardware license with WG, TSC, and Board approval. +\end{itemize} + +\subsection{Open Source Communities} + +This WG may accept Code from the following OS Communities under their respective licenses. + +This WG may accept or contribute Code from/to additional OS Communities with approval by the WG, TSC, and Board. +Any code accepted from or contributed to approved OS Communities must be under a Permissive License such as +Apache License, v2.0, 2 or 3 clause BSD, MIT, ISC, or other OS license approved by the WG, TSC, and Board. diff --git a/glossaries.tex b/glossaries.tex new file mode 100644 index 0000000..83621a8 --- /dev/null +++ b/glossaries.tex @@ -0,0 +1,11 @@ +\makeglossaries + +\renewcommand*{\glspostdescription}{} + +%%% Common Acronyms +\newacronym{IPR}{IPR}{Intellectual Property Rights} +\newacronym{SIG}{SIG}{Special Integration Work Group} +\newacronym{TWG}{TWG}{Technical Work Group} +\newacronym{STIG}{STIG}{Special Technical Integration Group} + +%%% Specific Acronyms diff --git a/opf-logo.png b/opf-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..4f80d8f2aa5e35b7ed9208d3d789fb2d62dc0322 GIT binary patch literal 5073 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 bUOk75EO9qI5;j~q{&qLeL1|Yb9i#sRQJ0n{ literal 0 HcmV?d00001