bin/pwd/pwd.1

   1 .\"     $NetBSD: pwd.1,v 1.25 2016/08/12 02:03:26 sevan Exp $
   2 .\"
   3 .\" Copyright (c) 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   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. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     @(#)pwd.1       8.2 (Berkeley) 4/28/95
  34 .\"
  35 .Dd August 12, 2016
  36 .Dt PWD 1
  37 .Os
  38 .Sh NAME
  39 .Nm pwd
  40 .Nd return working directory name
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl LP
  44 .Sh DESCRIPTION
  45 .Nm
  46 writes the absolute pathname of the current working directory to
  47 the standard output.
  48 .Pp
  49 The following options are available:
  50 .Bl -tag -width indent
  51 .It Fl L
  52 If the
  53 .Ev PWD
  54 environment variable is an absolute pathname that contains
  55 neither "/./" nor "/../" and references the current directory, then
  56 .Ev PWD
  57 is assumed to be the name of the current directory.
  58 .It Fl P
  59 Print the physical path to the current working directory, with symbolic
  60 links in the path resolved.
  61 .El
  62 .Pp
  63 The default for the
  64 .Nm
  65 command is
  66 .Fl P .
  67 .Pp
  68 .Nm
  69 is usually provided as a shell builtin (which may have a different
  70 default).
  71 .Sh EXIT STATUS
  72 The
  73 .Nm
  74 utility exits 0 on success, and \*[Gt]0 if an error occurs.
  75 .Sh SEE ALSO
  76 .Xr cd 1 ,
  77 .Xr csh 1 ,
  78 .Xr ksh 1 ,
  79 .Xr sh 1 ,
  80 .Xr getcwd 3
  81 .Sh STANDARDS
  82 The
  83 .Nm
  84 utility is expected to be conforming to
  85 .St -p1003.1 ,
  86 except that the default is
  87 .Fl P
  88 not
  89 .Fl L .
  90 .Sh HISTORY
  91 A
  92 .Nm
  93 utility appeared in
  94 .At v5 .
  95 .Sh BUGS
  96 In
  97 .Xr csh 1
  98 the command
  99 .Ic dirs
 100 is always faster (although it can give a different answer in the rare case
 101 that the current directory or a containing directory was moved after
 102 the shell descended into it).
 103 .Pp
 104 .Nm
 105 .Fl L
 106 relies on the file system having unique inode numbers.
 107 If this is not true (e.g., on FAT file systems) then
 108 .Nm
 109 .Fl L
 110 may fail to detect that
 111 .Ev PWD
 112 is incorrect.