diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/index.html | 8 | ||||
| -rw-r--r-- | doc/libnsss/index.html | 25 | ||||
| -rw-r--r-- | doc/upgrade.html | 10 |
3 files changed, 34 insertions, 9 deletions
diff --git a/doc/index.html b/doc/index.html index 9c155a1..62b37bd 100644 --- a/doc/index.html +++ b/doc/index.html @@ -81,11 +81,11 @@ functions. <li> A POSIX-compliant system with a standard C development environment </li> <li> GNU make, version 3.81 or later </li> <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> version -2.9.2.1 or later. It's a build-time requirement. It's also a run-time +2.10.0.0 or later. It's a build-time requirement. It's also a run-time requirement if you link against the shared version of the skalibs library. </li> <li> <a href="//skarnet.org/software/s6/">s6</a> version -2.9.1.0 or later. It's a <em>run-time</em> requirement only, to run +2.10.0.0 or later. It's a <em>run-time</em> requirement only, to run the nsssd service (and can be done without if you have a suitable replacement for <a href="//skarnet.org/software/s6/s6-ipcserver">s6-ipcserver</a>). </li> </ul> @@ -94,13 +94,13 @@ for <a href="//skarnet.org/software/s6/s6-ipcserver">s6-ipcserver</a>). </li> <p> nsss is free software. It is available under the -<a href="http://opensource.org/licenses/ISC">ISC license</a>. +<a href="https://opensource.org/licenses/ISC">ISC license</a>. </p> <h3> Download </h3> <ul> - <li> The current released version of nsss is <a href="nsss-0.0.2.2.tar.gz">0.0.2.2</a>. </li> + <li> The current released version of nsss is <a href="nsss-0.1.0.0.tar.gz">0.1.0.0</a>. </li> <li> Alternatively, you can checkout a copy of the <a href="//git.skarnet.org/cgi-bin/cgit.cgi/nsss/">nsss git repository</a>: diff --git a/doc/libnsss/index.html b/doc/libnsss/index.html index 3514c42..bbe5029 100644 --- a/doc/libnsss/index.html +++ b/doc/libnsss/index.html @@ -103,6 +103,17 @@ the other functions will be aliased similarly. </p> <p> + <tt>pwd.h</tt> can be found in the <tt>nsss/</tt> subdirectory of +the header installation directory; if the <tt>--enable-libc-includes</tt> +option has been given to configure, it can also be found directly +in that directory. (Example: <tt>/usr/include/nsss/pwd.h</tt> is +always installed, but if the option has been given at nsss build time, +<tt>/usr/include/pwd.h</tt> is also installed and replaces the +version provided by the libc.) This also applies to the <tt>grp.h</tt> +and <tt>shadow.h</tt> files. +</p> + +<p> If the NSSS_DISABLE_SWITCH macro is defined before inclusion of the nsss headers, then <tt>getpwnam()</tt> will be aliased to <tt>nsss_unix_getpwnam()</tt> instead, and the other functions will @@ -121,9 +132,17 @@ functions will follow the same pattern. are visible in your header search path. </li> <li> Use <tt>#include <nsss/nsss.h></tt> </li> <li> To use the standard <tt>pwd.h</tt> interface, you can -just <tt>#include <pwd.h></tt>, which will work as long -as the <tt>nsss/pwd.h</tt> header is accessible in your header -search path. </li> +just <tt>#include <pwd.h></tt>, which will work: + <ul> + <li> either if the <tt>--enable-libc-includes</tt> option +has been given at nsss build time </li> + <li> or if you give the <tt>-I/usr/include/nsss</tt> option +to your compiler. (Depending on your standard header location, +specify that the header search path should include the +<tt>nsss</tt> subdirectory of that location.) This is useful when +the administrator did not want to overwrite the libc-provided +<tt>pwd.h</tt> file when they installed nsss. </li> + </ul> </li> <li> Same thing for <tt>grp.h</tt> and <tt>shadow.h</tt>. </li> <li> If don't want to use the nsss-all implementation of "try nsss-switch and fall back to nsss-unix if it fails", then diff --git a/doc/upgrade.html b/doc/upgrade.html index b0ae772..00fffe3 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -18,11 +18,17 @@ <h1> What has changed in nsss </h1> -<h2> in 0.0.2.3 </h2> +<h2> in 0.1.0.0 </h2> <ul> <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> dependency bumped to -2.9.2.1. </li> +2.10.0.0. </li> + <li> <a href="//skarnet.org/software/s6/">s6</a> optional dependency bumped to +2.10.0.0. </li> + <li> The <tt>pwd.h</tt>, <tt>grp.h</tt> and <tt>shadow.h</tt> header files are +not installed by default anymore. You now need to explicitly give the +<tt>--enable-libc-includes</tt> configure option in order to install them. The +point of this change is to avoid overwriting libc headers accidentally. </li> </ul> <h2> in 0.0.2.2 </h2> |