man1p/type.1p

   1 .\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved
   2 .TH "TYPE" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
   3 .\" type
   4 .SH NAME
   5 type \- write a description of command type
   6 .SH SYNOPSIS
   7 .LP
   8 \fBtype\fP \fIname\fP\fB... \fP
   9 .SH DESCRIPTION
  10 .LP
  11 The \fItype\fP utility shall indicate how each argument would be interpreted
  12 if used as a command name.
  13 .SH OPTIONS
  14 .LP
  15 None.
  16 .SH OPERANDS
  17 .LP
  18 The following operand shall be supported:
  19 .TP 7
  20 \fIname\fP
  21 A name to be interpreted.
  22 .sp
  23 .SH STDIN
  24 .LP
  25 Not used.
  26 .SH INPUT FILES
  27 .LP
  28 None.
  29 .SH ENVIRONMENT VARIABLES
  30 .LP
  31 The following environment variables shall affect the execution of
  32 \fItype\fP:
  33 .TP 7
  34 \fILANG\fP
  35 Provide a default value for the internationalization variables that
  36 are unset or null. (See the Base Definitions volume of
  37 IEEE\ Std\ 1003.1-2001, Section 8.2, Internationalization Variables
  38 for
  39 the precedence of internationalization variables used to determine
  40 the values of locale categories.)
  41 .TP 7
  42 \fILC_ALL\fP
  43 If set to a non-empty string value, override the values of all the
  44 other internationalization variables.
  45 .TP 7
  46 \fILC_CTYPE\fP
  47 Determine the locale for the interpretation of sequences of bytes
  48 of text data as characters (for example, single-byte as
  49 opposed to multi-byte characters in arguments).
  50 .TP 7
  51 \fILC_MESSAGES\fP
  52 Determine the locale that should be used to affect the format and
  53 contents of diagnostic messages written to standard
  54 error.
  55 .TP 7
  56 \fINLSPATH\fP
  57 Determine the location of message catalogs for the processing of \fILC_MESSAGES
  58 \&.\fP
  59 .TP 7
  60 \fIPATH\fP
  61 Determine the location of \fIname\fP, as described in the Base Definitions
  62 volume of IEEE\ Std\ 1003.1-2001, Chapter 8, Environment Variables.
  63 .sp
  64 .SH ASYNCHRONOUS EVENTS
  65 .LP
  66 Default.
  67 .SH STDOUT
  68 .LP
  69 The standard output of \fItype\fP contains information about each
  70 operand in an unspecified format. The information provided
  71 typically identifies the operand as a shell built-in, function, alias,
  72 or keyword, and where applicable, may display the operand's
  73 pathname.
  74 .SH STDERR
  75 .LP
  76 The standard error shall be used only for diagnostic messages.
  77 .SH OUTPUT FILES
  78 .LP
  79 None.
  80 .SH EXTENDED DESCRIPTION
  81 .LP
  82 None.
  83 .SH EXIT STATUS
  84 .LP
  85 The following exit values shall be returned:
  86 .TP 7
  87 \ 0
  88 Successful completion.
  89 .TP 7
  90 >0
  91 An error occurred.
  92 .sp
  93 .SH CONSEQUENCES OF ERRORS
  94 .LP
  95 Default.
  96 .LP
  97 \fIThe following sections are informative.\fP
  98 .SH APPLICATION USAGE
  99 .LP
 100 Since \fItype\fP must be aware of the contents of the current shell
 101 execution environment (such as the lists of commands,
 102 functions, and built-ins processed by \fIhash\fP), it is always provided
 103 as a shell regular
 104 built-in. If it is called in a separate utility execution environment,
 105 such as one of the following:
 106 .sp
 107 .RS
 108 .nf
 109
 110 \fBnohup type writer
 111 find . -type f | xargs type
 112 \fP
 113 .fi
 114 .RE
 115 it might not produce accurate results.
 116 .SH EXAMPLES
 117 .LP
 118 None.
 119 .SH RATIONALE
 120 .LP
 121 None.
 122 .SH FUTURE DIRECTIONS
 123 .LP
 124 None.
 125 .SH SEE ALSO
 126 .LP
 127 \fIcommand\fP , \fIhash\fP
 128 .SH COPYRIGHT
 129 Portions of this text are reprinted and reproduced in electronic form
 130 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
 131 -- Portable Operating System Interface (POSIX), The Open Group Base
 132 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
 133 Electrical and Electronics Engineers, Inc and The Open Group. In the
 134 event of any discrepancy between this version and the original IEEE and
 135 The Open Group Standard, the original IEEE and The Open Group Standard
 136 is the referee document. The original Standard can be obtained online at
 137 http://www.opengroup.org/unix/online.html .