git.saurik.com Git - apple/shell_cmds.git/blob

1 .\" $NetBSD: logname.1,v 1.8 1997/10/19 04:20:06 lukem Exp $

2 .\"

5 .\"

6 .\" This code is derived from software contributed to Berkeley by

7 .\" the Institute of Electrical and Electronics Engineers, Inc.

8 .\"

9 .\" Redistribution and use in source and binary forms, with or without

10 .\" modification, are permitted provided that the following conditions

11 .\" are met:

12 .\" 1. Redistributions of source code must retain the above copyright

13 .\" notice, this list of conditions and the following disclaimer.

14 .\" 2. Redistributions in binary form must reproduce the above copyright

15 .\" notice, this list of conditions and the following disclaimer in the

16 .\" documentation and/or other materials provided with the distribution.

17 .\" 3. All advertising materials mentioning features or use of this software

18 .\" must display the following acknowledgement:

19 .\" This product includes software developed by the University of

20 .\" California, Berkeley and its contributors.

21 .\" 4. Neither the name of the University nor the names of its contributors

22 .\" may be used to endorse or promote products derived from this software

23 .\" without specific prior written permission.

24 .\"

25 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND

26 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

27 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

28 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE

29 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

30 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

31 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

32 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

33 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

34 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

35 .\" SUCH DAMAGE.

36 .\"

37 .\" @(#)logname.1 8.1 (Berkeley) 6/9/93

38 .\"

39 .Dd June 9, 1993

40 .Dt LOGNAME 1

41 .Os BSD 4.4

42 .Sh NAME

43 .Nm logname

44 .Nd display user's login name

45 .Sh SYNOPSIS

46 .Nm

47 .Sh DESCRIPTION

48 The

49 .Nm

50 utility writes the user's login name to standard output followed by

51 a newline.

52 .Pp

53 The

54 .Nm

55 utility explicitly ignores the

56 .Ev LOGNAME

57 and

58 .Ev USER

59 environment variables

60 because the environment cannot be trusted.

61 .Pp

62 The

63 .Nm

64 utility exits 0 on success, and >0 if an error occurs.

65 .Sh SEE ALSO

66 .Xr who 1 ,

67 .Xr whoami 1 ,

68 .Xr getlogin 2

69 .Sh STANDARDS

70 The

71 .Nm

72 utility conforms to

73 .St -p1003.2-92 .

74 .Sh HISTORY

75 The

76 .Nm

77 command appeared in

78 .Bx 4.4 .