usr/src/man/man1/units.1

   1 '\" te
   2 .\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH UNITS 1 "Sep 14, 1992"
   8 .SH NAME
   9 units \- converts quantities expressed in standard scales to other scales
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBunits\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBunits\fR converts quantities expressed in various standard scales to their
  20 equivalents in other scales. It works interactively in this fashion:
  21 .sp
  22 .in +2
  23 .nf
  24 You have:~~\fBinch\fR
  25 You want:~~\fBcm\fR
  26         * 2.540000e+00
  27 / 3.937008e\(mi01
  28 .fi
  29 .in -2
  30 .sp
  31
  32 .sp
  33 .LP
  34 A quantity is specified as a multiplicative combination of units optionally
  35 preceded by a numeric multiplier. Powers are indicated by suffixed positive
  36 integers, division by the usual sign:
  37 .sp
  38 .in +2
  39 .nf
  40 You have:~~\fB15 lbs force/in2\fR
  41 You want:~~\fBatm\fR
  42         * 1.020689e+00
  43         / 9.797299e\(mi01
  44 .fi
  45 .in -2
  46 .sp
  47
  48 .sp
  49 .LP
  50 \fBunits\fR only does multiplicative scale changes; thus it can convert Kelvin
  51 to Rankine, but not Celsius to Fahrenheit. Most familiar units, abbreviations,
  52 and metric prefixes are recognized, together with a generous leavening of
  53 exotica and a few constants of nature including:
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fBpi\fR\fR
  58 .ad
  59 .RS 9n
  60 ratio of circumference to diameter,
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fBc\fR\fR
  67 .ad
  68 .RS 9n
  69 speed of light,
  70 .RE
  71
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fBe\fR\fR
  76 .ad
  77 .RS 9n
  78 charge on an electron,
  79 .RE
  80
  81 .sp
  82 .ne 2
  83 .na
  84 \fB\fBg\fR\fR
  85 .ad
  86 .RS 9n
  87 acceleration of gravity,
  88 .RE
  89
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fBforce\fR\fR
  94 .ad
  95 .RS 9n
  96 same as \fBg\fR,
  97 .RE
  98
  99 .sp
 100 .ne 2
 101 .na
 102 \fB\fBmole\fR\fR
 103 .ad
 104 .RS 9n
 105 Avogadro's number,
 106 .RE
 107
 108 .sp
 109 .ne 2
 110 .na
 111 \fB\fBwater\fR\fR
 112 .ad
 113 .RS 9n
 114 pressure head per unit height of water,
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fBau\fR\fR
 121 .ad
 122 .RS 9n
 123 astronomical unit.
 124 .RE
 125
 126 .sp
 127 .LP
 128 \fBPound\fR is not recognized as a unit of mass; \fBlb\fR is. Compound names
 129 are run together, (for example, \fBlightyear\fR). British units that differ
 130 from their U.S. counterparts are prefixed thus: \fBbrgallon\fR. For a complete
 131 list of units, type:
 132 .sp
 133 .LP
 134 \fBcat /usr/share/lib/unittab\fR
 135 .SH FILES
 136 .sp
 137 .LP
 138 \fB/usr/share/lib/unittab\fR
 139 .SH SEE ALSO
 140 .sp
 141 .LP
 142 \fBattributes\fR(5)