logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

unalias.1p (4892B)

    

  1. '\" et
  2. .TH UNALIAS "1P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. unalias
  12. \(em remove alias definitions
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. unalias \fIalias-name\fR...
  17. .P
  18. unalias -a
  19. .fi
  20. .SH DESCRIPTION
  21. The
  22. .IR unalias
  23. utility shall remove the definition for each alias name specified. See
  24. .IR "Section 2.3.1" ", " "Alias Substitution".
  25. The aliases shall be removed from the current shell execution
  26. environment; see
  27. .IR "Section 2.12" ", " "Shell Execution Environment".
  28. .SH OPTIONS
  29. The
  30. .IR unalias
  31. utility shall conform to the Base Definitions volume of POSIX.1\(hy2017,
  32. .IR "Section 12.2" ", " "Utility Syntax Guidelines".
  33. .P
  34. The following option shall be supported:
  35. .IP "\fB\-a\fP" 10
  36. Remove all alias definitions from the current shell execution
  37. environment.
  38. .SH OPERANDS
  39. The following operand shall be supported:
  40. .IP "\fIalias-name\fR" 10
  41. The name of an alias to be removed.
  42. .SH STDIN
  43. Not used.
  44. .SH "INPUT FILES"
  45. None.
  46. .SH "ENVIRONMENT VARIABLES"
  47. The following environment variables shall affect the execution of
  48. .IR unalias :
  49. .IP "\fILANG\fP" 10
  50. Provide a default value for the internationalization variables that are
  51. unset or null. (See the Base Definitions volume of POSIX.1\(hy2017,
  52. .IR "Section 8.2" ", " "Internationalization Variables"
  53. for the precedence of internationalization variables used to determine
  54. the values of locale categories.)
  55. .IP "\fILC_ALL\fP" 10
  56. If set to a non-empty string value, override the values of all the
  57. other internationalization variables.
  58. .IP "\fILC_CTYPE\fP" 10
  59. Determine the locale for the interpretation of sequences of bytes of
  60. text data as characters (for example, single-byte as opposed to
  61. multi-byte characters in arguments).
  62. .IP "\fILC_MESSAGES\fP" 10
  63. .br
  64. Determine the locale that should be used to affect the format and
  65. contents of diagnostic messages written to standard error.
  66. .IP "\fINLSPATH\fP" 10
  67. Determine the location of message catalogs for the processing of
  68. .IR LC_MESSAGES .
  69. .SH "ASYNCHRONOUS EVENTS"
  70. Default.
  71. .SH STDOUT
  72. Not used.
  73. .SH STDERR
  74. The standard error shall be used only for diagnostic messages.
  75. .SH "OUTPUT FILES"
  76. None.
  77. .SH "EXTENDED DESCRIPTION"
  78. None.
  79. .SH "EXIT STATUS"
  80. The following exit values shall be returned:
  81. .IP "\00" 6
  82. Successful completion.
  83. .IP >0 6
  84. One of the
  85. .IR alias-name
  86. operands specified did not represent a valid alias definition, or an
  87. error occurred.
  88. .SH "CONSEQUENCES OF ERRORS"
  89. Default.
  90. .LP
  91. .IR "The following sections are informative."
  92. .SH "APPLICATION USAGE"
  93. Since
  94. .IR unalias
  95. affects the current shell execution environment, it is generally
  96. provided as a shell regular built-in.
  97. .SH EXAMPLES
  98. None.
  99. .SH RATIONALE
  100. The
  101. .IR unalias
  102. description is based on that from historical KornShell implementations.
  103. Known differences exist between that and the C shell. The KornShell
  104. version was adopted to be consistent with all the other KornShell
  105. features in this volume of POSIX.1\(hy2017, such as command line editing.
  106. .P
  107. The
  108. .BR \-a
  109. option is the equivalent of the
  110. .IR unalias
  111. * form of the C shell and is provided to address security concerns
  112. about unknown aliases entering the environment of a user (or
  113. application) through the allowable implementation-defined predefined
  114. alias route or as a result of an
  115. .IR ENV
  116. file. (Although
  117. .IR unalias
  118. could be used to simplify the ``secure'' shell script shown in the
  119. .IR command
  120. rationale, it does not obviate the need to quote all command names. An
  121. initial call to
  122. .IR unalias
  123. .BR \-a
  124. would have to be quoted in case there was an alias for
  125. .IR unalias .)
  126. .SH "FUTURE DIRECTIONS"
  127. None.
  128. .SH "SEE ALSO"
  129. .IR "Chapter 2" ", " "Shell Command Language",
  130. .IR "\fIalias\fR\^"
  131. .P
  132. The Base Definitions volume of POSIX.1\(hy2017,
  133. .IR "Chapter 8" ", " "Environment Variables",
  134. .IR "Section 12.2" ", " "Utility Syntax Guidelines"
  135. .\"
  136. .SH COPYRIGHT
  137. Portions of this text are reprinted and reproduced in electronic form
  138. from IEEE Std 1003.1-2017, Standard for Information Technology
  139. -- Portable Operating System Interface (POSIX), The Open Group Base
  140. Specifications Issue 7, 2018 Edition,
  141. Copyright (C) 2018 by the Institute of
  142. Electrical and Electronics Engineers, Inc and The Open Group.
  143. In the event of any discrepancy between this version and the original IEEE and
  144. The Open Group Standard, the original IEEE and The Open Group Standard
  145. is the referee document. The original Standard can be obtained online at
  146. http://www.opengroup.org/unix/online.html .
  147. .PP
  148. Any typographical or formatting errors that appear
  149. in this page are most likely
  150. to have been introduced during the conversion of the source files to
  151. man page format. To report such errors, see
  152. https://www.kernel.org/doc/man-pages/reporting_bugs.html .