Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 264130 | Differences between
and this patch

Collapse All | Expand All

(-)a/eapi-differences.tex (+4 lines)
Lines 261-266 Controllable compression & \compactfeatureref{controllable-compress} & No & No & Link Here
261
\t{default} function & \compactfeatureref{default-func} & No & No &
261
\t{default} function & \compactfeatureref{default-func} & No & No &
262
    \IFANYKDEBUILDELSE{\IFKDEBUILDCOLOUR{No} &}{} Yes & Yes & Yes \\
262
    \IFANYKDEBUILDELSE{\IFKDEBUILDCOLOUR{No} &}{} Yes & Yes & Yes \\
263
263
264
File mtimes preserved & \compactfeatureref{mtime-preserve} & Undefined & Undefined &
265
    \IFANYKDEBUILDELSE{\IFKDEBUILDCOLOUR{Undefined} &}{} Undefined & Yes & Yes \\
266
264
\end{longtable}
267
\end{longtable}
265
\end{landscape}
268
\end{landscape}
266
269
Lines 327-332 EAPI 2 is EAPI 1 with the following changes: Link Here
327
330
328
EAPI 3 is EAPI 2 with the following changes:
331
EAPI 3 is EAPI 2 with the following changes:
329
\begin{compactitem}
332
\begin{compactitem}
333
\item File modification times are preserved, \featureref{mtime-preserve}.
330
\item (to be completed)
334
\item (to be completed)
331
\end{compactitem}
335
\end{compactitem}
332
336
(-)a/merge.tex (-3 / +58 lines)
Lines 60-68 as follows: Link Here
60
    set*id bit set.
60
    set*id bit set.
61
\end{compactitem}
61
\end{compactitem}
62
62
63
On SELinux systems, the SELinux context must also be preserved. Other file attributes, including
63
On SELinux systems, the SELinux context must also be preserved. Other
64
modification time, may be discarded.
64
file attributes may be discarded.
65
66
\subsection{File modification times}
67
68
\featurelabel{mtime-preserve}
69
In EAPIs listed in table~\ref{tab:mtime-preserve}, the package manager
70
must preserve modification times of regular files. This includes files
71
being compressed before merging. Exceptions to this are files newly
72
created by the package manager and binary object files being stripped
73
of symbols.
74
75
When preserving, the seconds part of every regular file's mtime must
76
be preserved exactly. The sub-second part must either be set to zero,
77
or set to the greatest value supported by the operating system and
78
filesystem that is not greater than the original time.
79
80
For any given destination filesystem, the package manager must ensure
81
that there are no two preserved files $a$, $b$ in that filesystem such
82
that the comparison $\mbox{mtime}(a) \leq \mbox{mtime}(b)$ does not
83
give the same result as the same comparison would have given under the
84
original image directory.
85
86
In other EAPIs, the behaviour with respect to file modification times
87
is undefined.
88
89
\begin{centertable}{Preservation of file modification times (mtimes)}
90
    \label{tab:mtime-preserve}
91
\IFKDEBUILDELSE
92
{
93
    \begin{tabular}{ l l }
94
        \toprule
95
            \multicolumn{1}{c}{\textbf{EAPI}} &
96
            \multicolumn{1}{c}{\textbf{mtimes preserved?}} \\
97
            \midrule
98
    \t{0} & Undefined \\
99
    \t{1} & Undefined \\
100
    \t{kdebuild-1} & Undefined \\
101
    \t{2} & Undefined \\
102
    \t{3} & Yes \\
103
    \t{4} & Yes \\
104
    \bottomrule
105
    \end{tabular}
106
}{
107
    \begin{tabular}{ l l }
108
        \toprule
109
            \multicolumn{1}{c}{\textbf{EAPI}} &
110
            \multicolumn{1}{c}{\textbf{mtimes preserved?}} \\
111
            \midrule
112
    \t{0} & Undefined \\
113
    \t{1} & Undefined \\
114
    \t{2} & Undefined \\
115
    \t{3} & Yes \\
116
    \t{4} & Yes \\
117
    \bottomrule
118
    \end{tabular}
119
}
120
\end{centertable}
65
121
66
\subsection{Configuration File Protection}
122
\subsection{Configuration File Protection}
67
\label{sec:config-protect}
123
\label{sec:config-protect}
68
- 

Return to bug 264130