1STRIP(1P)                  POSIX Programmer's Manual                 STRIP(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       strip — remove unnecessary information from strippable files  (DEVELOP‐
13       MENT)
14

SYNOPSIS

16       strip file...
17

DESCRIPTION

19       A  strippable  file  is defined as a relocatable, object, or executable
20       file.  On XSI-conformant systems, a strippable file can also be an  ar‐
21       chive of object or relocatable files.
22
23       The  strip utility shall remove from strippable files named by the file
24       operands any information the implementor deems unnecessary  for  execu‐
25       tion of those files. The nature of that information is unspecified. The
26       effect of strip on object and executable files shall be similar to  the
27       use  of  the -s option to c99 or fort77.  The effect of strip on an ar‐
28       chive of object files shall be similar to the use of the -s  option  to
29       c99 or fort77 for each object file in the archive.
30

OPTIONS

32       None.
33

OPERANDS

35       The following operand shall be supported:
36
37       file      A pathname referring to a strippable file.
38

STDIN

40       Not used.
41

INPUT FILES

43       The  input  files shall be in the form of strippable files successfully
44       produced by any compiler defined by this volume of POSIX.1‐2017 or pro‐
45       duced  by  creating  or  updating an archive of such files using the ar
46       utility.
47

ENVIRONMENT VARIABLES

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

ASYNCHRONOUS EVENTS

74       Default.
75

STDOUT

77       Not used.
78

STDERR

80       The standard error shall be used only for diagnostic messages.
81

OUTPUT FILES

83       The strip utility shall produce strippable files of unspecified format.
84

EXTENDED DESCRIPTION

86       None.
87

EXIT STATUS

89       The following exit values shall be returned:
90
91        0    Successful completion.
92
93       >0    An error occurred.
94

CONSEQUENCES OF ERRORS

96       Default.
97
98       The following sections are informative.
99

APPLICATION USAGE

101       None.
102

EXAMPLES

104       None.
105

RATIONALE

107       Historically,  this  utility  has  been used to remove the symbol table
108       from a strippable file. It was included since  it  is  known  that  the
109       amount  of  symbolic  information  can amount to several megabytes; the
110       ability to remove it in a portable manner was deemed  important,  espe‐
111       cially for smaller systems.
112
113       The  behavior of strip on object and executable files is said to be the
114       same as the -s option to a compiler. While the  end  result  is  essen‐
115       tially the same, it is not required to be identical.
116
117       XSI-conformant systems support use of strip on archive files containing
118       object files or relocatable files.
119

FUTURE DIRECTIONS

121       None.
122

SEE ALSO

124       ar, c99, fort77
125
126       The Base Definitions volume of  POSIX.1‐2017,  Chapter  8,  Environment
127       Variables
128
130       Portions  of  this text are reprinted and reproduced in electronic form
131       from IEEE Std 1003.1-2017, Standard for Information Technology --  Por‐
132       table  Operating System Interface (POSIX), The Open Group Base Specifi‐
133       cations Issue 7, 2018 Edition, Copyright (C) 2018 by the  Institute  of
134       Electrical  and  Electronics Engineers, Inc and The Open Group.  In the
135       event of any discrepancy between this version and the original IEEE and
136       The  Open Group Standard, the original IEEE and The Open Group Standard
137       is the referee document. The original Standard can be  obtained  online
138       at http://www.opengroup.org/unix/online.html .
139
140       Any  typographical  or  formatting  errors that appear in this page are
141       most likely to have been introduced during the conversion of the source
142       files  to  man page format. To report such errors, see https://www.ker
143       nel.org/doc/man-pages/reporting_bugs.html .
144
145
146
147IEEE/The Open Group                  2017                            STRIP(1P)
Impressum