|
Lines 22-32
Ebuilds must not call nor assume the existence of any phase functions.
Link Here
|
| 22 |
\subsection{Initial working directories} |
22 |
\subsection{Initial working directories} |
| 23 |
\label{sec:s-to-workdir-fallback} |
23 |
\label{sec:s-to-workdir-fallback} |
| 24 |
|
24 |
|
| 25 |
Some functions may assume that their initial working directory is set to a particular location; |
25 |
\featurelabel{phase-function-dir} Some functions may assume that their initial working directory is |
| 26 |
these are noted below. If no initial working directory is mandated, it may be set to anything and |
26 |
set to a particular location; these are noted below. If no initial working directory is mandated, |
| 27 |
the ebuild must not rely upon a particular location for it. The ebuild \emph{may} assume that the |
27 |
then for EAPIs listed in table~\ref{tab:function-dirs} as having an empty directory, it must be set |
| 28 |
initial working directory for any phase is a trusted location that may only be written to by a |
28 |
to a dedicated directory that is empty at the start of the function and may be read-only. For other |
| 29 |
privileged user and group. |
29 |
EAPIs, it may be set to anything. The ebuild must not rely upon a particular location for it. |
|
|
30 |
The ebuild \emph{may} assume that the initial working directory for any phase is a trusted location |
| 31 |
that may only be written to by a privileged user and group. |
| 30 |
|
32 |
|
| 31 |
\featurelabel{s-workdir-fallback} Some functions are described as having an initial working |
33 |
\featurelabel{s-workdir-fallback} Some functions are described as having an initial working |
| 32 |
directory of \t{S} with an error or fallback to \t{WORKDIR}\@. For EAPIs listed in |
34 |
directory of \t{S} with an error or fallback to \t{WORKDIR}\@. For EAPIs listed in |
|
Lines 44-49
fallback to \t{WORKDIR} is used:
Link Here
|
| 44 |
executed, are in \t{DEFINED_PHASES}. |
46 |
executed, are in \t{DEFINED_PHASES}. |
| 45 |
\end{compactitem} |
47 |
\end{compactitem} |
| 46 |
|
48 |
|
|
|
49 |
\ChangeWhenAddingAnEAPI{8} |
| 50 |
\begin{centertable}{Default initial working directory in functions for EAPIs} |
| 51 |
\label{tab:function-dirs} |
| 52 |
\begin{tabular}{ll} |
| 53 |
\toprule |
| 54 |
\multicolumn{1}{c}{\textbf{EAPI}} & |
| 55 |
\multicolumn{1}{c}{\textbf{Working dir?}} \\ |
| 56 |
\midrule |
| 57 |
0, 1, 2, 3, 4, 5, 6, 7 & Any \\ |
| 58 |
8 & Empty \\ |
| 59 |
\bottomrule |
| 60 |
\end{tabular} |
| 61 |
\end{centertable} |
| 62 |
|
| 47 |
\ChangeWhenAddingAnEAPI{8} |
63 |
\ChangeWhenAddingAnEAPI{8} |
| 48 |
\begin{centertable}{EAPIs with \t{S} to \t{WORKDIR} fallbacks} |
64 |
\begin{centertable}{EAPIs with \t{S} to \t{WORKDIR} fallbacks} |
| 49 |
\label{tab:s-fallback-table} |
65 |
\label{tab:s-fallback-table} |
| 50 |
- |
|
|
