1UNALIAS(1P)                POSIX Programmer's Manual               UNALIAS(1P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       unalias - remove alias definitions
13

SYNOPSIS

15       unalias alias-name...
16
17       unalias -a
18
19

DESCRIPTION

21       The unalias utility shall remove the definition  for  each  alias  name
22       specified.  See  Alias Substitution . The aliases shall be removed from
23       the current shell execution environment; see Shell  Execution  Environ‐
24       ment .
25

OPTIONS

27       The  unalias  utility  shall  conform to the Base Definitions volume of
28       IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.
29
30       The following option shall be supported:
31
32       -a     Remove all alias definitions from the  current  shell  execution
33              environment.
34
35

OPERANDS

37       The following operand shall be supported:
38
39       alias-name
40              The name of an alias to be removed.
41
42

STDIN

44       Not used.
45

INPUT FILES

47       None.
48

ENVIRONMENT VARIABLES

50       The  following environment variables shall affect the execution of una‐
51       lias:
52
53       LANG   Provide a default value for the  internationalization  variables
54              that  are  unset  or  null.  (See the Base Definitions volume of
55              IEEE Std 1003.1-2001, Section  8.2,  Internationalization  Vari‐
56              ables  for the precedence of internationalization variables used
57              to determine the values of locale categories.)
58
59       LC_ALL If set to a non-empty string value, override the values  of  all
60              the other internationalization variables.
61
62       LC_CTYPE
63              Determine  the  locale  for  the  interpretation of sequences of
64              bytes of text data as characters (for  example,  single-byte  as
65              opposed to multi-byte characters in arguments).
66
67       LC_MESSAGES
68              Determine  the  locale  that should be used to affect the format
69              and contents of diagnostic messages written to standard error.
70
71       NLSPATH
72              Determine the location of message catalogs for the processing of
73              LC_MESSAGES .
74
75

ASYNCHRONOUS EVENTS

77       Default.
78

STDOUT

80       Not used.
81

STDERR

83       The standard error shall be used only for diagnostic messages.
84

OUTPUT FILES

86       None.
87

EXTENDED DESCRIPTION

89       None.
90

EXIT STATUS

92       The following exit values shall be returned:
93
94        0     Successful completion.
95
96       >0     One  of  the  alias-name  operands specified did not represent a
97              valid alias definition, or an error occurred.
98
99

CONSEQUENCES OF ERRORS

101       Default.
102
103       The following sections are informative.
104

APPLICATION USAGE

106       Since unalias affects the current shell execution  environment,  it  is
107       generally provided as a shell regular built-in.
108

EXAMPLES

110       None.
111

RATIONALE

113       The  unalias  description  is  based  on that from historical KornShell
114       implementations. Known differences exist between that and the C  shell.
115       The  KornShell  version was adopted to be consistent with all the other
116       KornShell features in this volume of IEEE Std 1003.1-2001, such as com‐
117       mand line editing.
118
119       The  -a  option  is the equivalent of the unalias * form of the C shell
120       and is provided to address  security  concerns  about  unknown  aliases
121       entering  the environment of a user (or application) through the allow‐
122       able implementation-defined predefined alias route or as a result of an
123       ENV  file.  (Although  unalias  could  be used to simplify the "secure"
124       shell script shown in the command rationale, it does  not  obviate  the
125       need  to  quote  all command names. An initial call to unalias -a would
126       have to be quoted in case there was an alias for unalias.)
127

FUTURE DIRECTIONS

129       None.
130

SEE ALSO

132       Shell Command Language, alias
133
135       Portions of this text are reprinted and reproduced in  electronic  form
136       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
137       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
138       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
139       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
140       event of any discrepancy between this version and the original IEEE and
141       The Open Group Standard, the original IEEE and The Open Group  Standard
142       is  the  referee document. The original Standard can be obtained online
143       at http://www.opengroup.org/unix/online.html .
144
145
146
147IEEE/The Open Group                  2003                          UNALIAS(1P)
Impressum