INSTALL.1
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:4k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. .TH INSTALL 1
  2. .SH NAME
  3. install - install files
  4. .SH SYNOPSIS
  5. .in +5
  6. .ti -5
  7. .B install
  8. .RB [ -lcszfINfP "] [" -o
  9. .IR owner ]
  10. .RB [ -g
  11. .IR group ]
  12. .RB [ -m
  13. .IR mode ]
  14. .RB [ -S
  15. .IR stack ]
  16. .RI [ file1 ]
  17. .I file2
  18. .br
  19. .ti -5
  20. .B install
  21. .RB [ -lcszfINfP "] [" -o
  22. .IR owner ]
  23. .RB [ -g
  24. .IR group ]
  25. .RB [ -m
  26. .IR mode ]
  27. .RB [ -S
  28. .IR stack ]
  29. .IR file " ... " dir
  30. .br
  31. .ti -5
  32. .B install -d
  33. .RB [ -o
  34. .IR owner ]
  35. .RB [ -g
  36. .IR group ]
  37. .RB [ -m
  38. .IR mode ]
  39. .I directory
  40. .in -5
  41. .SH DESCRIPTION
  42. .de SP
  43. .if t .sp 0.4
  44. .if n .sp
  45. ..
  46. .B Install
  47. puts executables, manual pages, and library files in their proper place
  48. in the bin, man, and lib directories.  The first two forms of the
  49. command are like
  50. .BR cp (1)
  51. copying either one file to another or copying several files to a
  52. directory.  The "fB-dfP" form is like
  53. .BR mkdir (1)
  54. with the
  55. .B -p
  56. flag.
  57. .I File1
  58. may be omitted if neither
  59. .B -l
  60. nor
  61. .B -c
  62. is given to change the attributes of
  63. .IR file2 .
  64. .PP
  65. Attributes are always copied from the source file, use the options to change.
  66. Note that the source file's attributes are changed with the destination file
  67. if they are linked.  So copy the file if you change it in a way that makes
  68. it read-only.  You would otherwise not be able to compile a command again.
  69. .SH OPTIONS
  70. .TP
  71. .B -l
  72. Link the destination to the source file instead of copying it.  This is done
  73. to either save space on a file system with both the source and the bin
  74. directories on it, or to install synonyms to a command.
  75. .TP
  76. .B -c
  77. Copy the source file to its proper place.  This option is the default if
  78. .B -l
  79. is not given.  With
  80. .BR -l ,
  81. the file is copied if the link fails.
  82. .TP
  83. .B -s
  84. Strip the destination file of its symbol table,
  85. .I if
  86. it is an executable, and
  87. .I if
  88. it is actually copied.  It has no effect on a link or a non-executable.
  89. .TP
  90. .B -z
  91. Compress the executable using
  92. .BR compress (1)
  93. and prepend a header line that calls
  94. .BR zexec (1)
  95. to decompress and execute the binary.  This will on average save 40% disk
  96. space at the expense of a slower startup time.  Like
  97. .B -s
  98. the file must be actually copied for the flag to have effect.
  99. .TP
  100. .BI - N
  101. Use
  102. .BI "gzip -" N
  103. to compress the binary.  You may see up to 60% space savings, but it will
  104. take much longer.
  105. .I N
  106. is a digit from 1 to 9 telling the compression effort, see
  107. .BR gzip (1).
  108. .TP
  109. .B -d
  110. Make a directory, usually to install files in a separate directory in a
  111. library.  Intermediate directories in the path are created with the same
  112. attributes as the final directory.  Only the attributes of the final
  113. directory are set if the directory exists.
  114. .TP
  115. .BI -o " owner"
  116. Set the owner of the target.  This only works if the invoker is the
  117. super-user, or if
  118. .B install
  119. is run setuid root and the invoker is a member of group zero.  If
  120. .B -o
  121. is omitted then the ownership is copied from the source file, or set to
  122. the id of the invoker if a directory is made.
  123. .TP
  124. .BI -g " group"
  125. Like
  126. .BR -o ,
  127. but for the group ownership of the target.
  128. .TP
  129. .BI -m " mode"
  130. .I Mode
  131. is an octal number that specifies the mode the target should get.  The
  132. default is the source file's mode with a
  133. .B chmod a+rX
  134. applied to it, or 755 for a new directory.  Implies
  135. .BR "-o 0" ,
  136. or
  137. .BR "-g 0"
  138. if a file is to be set-uid or set-gid and the invoker has permission to
  139. change ownership.  This trick allows a group 0 member to install third party
  140. software, even though it expects to be installed by root.
  141. .TP
  142. .BI -S " stack"
  143. Sets the maximum amount of heap + stack that an executable may have when
  144. running.  The argument is a C-style decimal, octal or hexadecimal
  145. number, optionally followed by the multipliers
  146. .BR m ,
  147. .BR k ,
  148. .BR w ,
  149. and
  150. .B b
  151. for mega (1024*1024), kilo (1024), "word" (2 or 4), and byte (1).  Uppercase
  152. .B M
  153. is also accepted for those who know what S.I. means.  The compilers use
  154. .B -S 32kw
  155. by default, that translates to 64kb for an 8086, and 128kb for other
  156. architectures.  This option is ignored on a non-executable.
  157. .SH "SEE ALSO"
  158. .BR ln (1),
  159. .BR cp (1),
  160. .BR strip (1),
  161. .BR compress (1),
  162. .BR gzip (1),
  163. .BR zexec (1),
  164. .BR chown (8),
  165. .BR chgrp (8),
  166. .BR chmod (1),
  167. .BR chmem (1),
  168. .BR mkdir (1).
  169. .SH BUGS
  170. Uppercase
  171. .BR K ,
  172. .BR W ,
  173. and
  174. .B B
  175. are also accepted for those who don't know what S.I. means.
  176. .SH AUTHOR
  177. Kees J. Bot (kjb@cs.vu.nl)