summaryrefslogtreecommitdiff
path: root/packages/google-compute-engine-oslogin/nss_module/nss-cache-oslogin.8
diff options
context:
space:
mode:
Diffstat (limited to 'packages/google-compute-engine-oslogin/nss_module/nss-cache-oslogin.8')
-rw-r--r--packages/google-compute-engine-oslogin/nss_module/nss-cache-oslogin.848
1 files changed, 48 insertions, 0 deletions
diff --git a/packages/google-compute-engine-oslogin/nss_module/nss-cache-oslogin.8 b/packages/google-compute-engine-oslogin/nss_module/nss-cache-oslogin.8
new file mode 100644
index 0000000..aaf4f8e
--- /dev/null
+++ b/packages/google-compute-engine-oslogin/nss_module/nss-cache-oslogin.8
@@ -0,0 +1,48 @@
+'\" t
+.TH "NSS\-CACHE\-OSLOGIN" "8" "2019-06-06" "Google Cloud"
+
+.\" IF GNU troff set Aq to sequence aq (Apostrophe quote)
+.ie \n(.g .ds Aq \(aq
+.\" ELSE set Aq to '
+.el .ds Aq '
+
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+
+.SH "NAME"
+nss-cache-oslogin, libnss_cache_oslogin.so.2 \- UNIX implementation for OS Login Users and Groups with local caching\&.
+
+.SH "SYNOPSIS"
+libnss_cache_oslogin\&.so\&.2
+
+.SH "DESCRIPTION"
+\fBnss\-cache\-oslogin\fR is a plug\-in module for the GNU Name Service Switch
+(NSS) functionality of the GNU C Library (\fBglibc\fR)\&.
+This module provides UNIX name resolution from a local cache of users and groups
+configured in the \fIGoogle Cloud OS Login\fR system\&.
+The "passwd" and "group" services are supported by this module\&.
+.PP
+To use the NSS module, add "cache_oslogin" to the appropriate service lines
+in nsswitch\&.conf\&.
+It is recommended to place "cache_oslogin" after any system provided modules
+and before the "oslogin" module, as it is a pass-through cache.
+
+.SH "FILES"
+.IP /etc/oslogin_passwd.cache
+user cache file
+.IP /etc/oslogin_group.cache
+group cache file
+
+.SH "NOTES"
+Documentation for the Google Cloud OS Login service is available online at
+.UR "https://cloud.google.com/compute/docs/oslogin"
+.UE
+
+.SH "SEE ALSO"
+.BR nss-oslogin (5),
+.BR nsswitch.conf (5),
+.BR nss (5),
+.BR getent (1),
+.BR initgroups (3)