From 1cde5d8ea28e66905e96150f166d2cfc595f2049 Mon Sep 17 00:00:00 2001
From: Kevin Fall <kfall@ucbvax.Berkeley.EDU>
Date: Fri, 19 May 1989 02:10:09 -0800
Subject: [PATCH] date and time created 89/05/18 19:10:09 by kfall

SCCS-vsn: lib/libc/sys/getlogin.2 1.1
---
 usr/src/lib/libc/sys/getlogin.2 | 75 +++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 usr/src/lib/libc/sys/getlogin.2

diff --git a/usr/src/lib/libc/sys/getlogin.2 b/usr/src/lib/libc/sys/getlogin.2
new file mode 100644
index 0000000000..2c994d96a4
--- /dev/null
+++ b/usr/src/lib/libc/sys/getlogin.2
@@ -0,0 +1,75 @@
+.\" Copyright (c) 1989 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.\"	@(#)getlogin.2	1.1 (Berkeley) %G%
+.\"
+.TH GETLOGNAME 2 ""
+.UC 5
+.SH NAME
+getlogname, setlogname \- get/set login name of process owner
+.SH SYNOPSIS
+.nf
+.ft B
+getlogname(name, namelen)
+char *name;
+int namelen;
+.PP
+.ft B
+setlogname(name, namelen)
+char *name;
+int namelen;
+.fi
+.SH DESCRIPTION
+.I Getlogname
+returns the login name of the owner of the current process, as
+previously set by
+.IR setlogname . 
+The parameter
+.I namelen
+specifies the size of the 
+.I name
+array.  The returned name is null-terminated unless insufficient
+space is provided.
+The preferred method for retrieving this information is through the
+.IR getlogin (3)
+library routine.
+.PP
+.I Setlogname
+sets the login name of the process owner to be
+.IR name ,
+which has length
+.IR namelen .
+This call is restricted to the super-user and
+is normally used only at login time, or when a remote shell
+is invoked.
+.SH "RETURN VALUE
+If the call succeeds, a value of 0 is returned.  If the call
+fails, then a value of \-1 is returned and an error code is
+placed in the global location \fIerrno\fP.
+.SH "ERRORS
+The following errors may be returned by these calls:
+.TP 15
+[EFAULT]
+The \fIname\fP or \fInamelen\fP parameter gave an
+invalid address.
+.TP 15
+[EPERM]
+The caller tried to set the hostname and was not the super-user.
+.SH SEE ALSO
+getlogin(3)
+.SH BUGS
+Host names are limited to MAXLOGNAME (from
+.IR <sys/user.h> )
+characters, currently 12.
-- 
2.20.1