1 bf8a59fa 2004-04-11 devnull .TH MACH-SWAP 3
  2 bf8a59fa 2004-04-11 devnull .SH NAME
  3 bf8a59fa 2004-04-11 devnull beswap2, beswap4, beswap8, beieeeftoa32, beieeeftoa64, beieeeftoa80,
  4 bf8a59fa 2004-04-11 devnull beload2, beload4, beload8,
  5 bf8a59fa 2004-04-11 devnull leswap2, leswap4, leswap8, leieeeftoa32, leieeeftoa64, leieeeftoa80,
  6 bf8a59fa 2004-04-11 devnull leload2, leload4, leload8, ieeeftoa32, ieeeftoa64 \- machine-independent access to byte-ordered data
  7 bf8a59fa 2004-04-11 devnull .SH SYNOPSIS
  8 bf8a59fa 2004-04-11 devnull .B #include <u.h>
  9 bf8a59fa 2004-04-11 devnull .br
 10 bf8a59fa 2004-04-11 devnull .B #include <libc.h>
 11 bf8a59fa 2004-04-11 devnull .br
 12 bf8a59fa 2004-04-11 devnull .B #include <mach.h>
 13 bf8a59fa 2004-04-11 devnull .PP
 14 bf8a59fa 2004-04-11 devnull .ta \w'\fBu64intxx'u
 15 bf8a59fa 2004-04-11 devnull .B
 16 bf8a59fa 2004-04-11 devnull u16int	beswap2(u16int u)
 17 bf8a59fa 2004-04-11 devnull .br
 18 bf8a59fa 2004-04-11 devnull u32int	beswap4(u32int u)
 19 bf8a59fa 2004-04-11 devnull .br
 20 bf8a59fa 2004-04-11 devnull u64int	beswap8(u64int u)
 21 bf8a59fa 2004-04-11 devnull .PP
 22 bf8a59fa 2004-04-11 devnull .B
 23 bf8a59fa 2004-04-11 devnull int	beieeeftoa32(char *a, uint n, void *f)
 24 bf8a59fa 2004-04-11 devnull .br
 25 bf8a59fa 2004-04-11 devnull int	beieeeftoa64(char *a, uint n, void *f)
 26 bf8a59fa 2004-04-11 devnull .br
 27 bf8a59fa 2004-04-11 devnull int	beieeeftoa80(char *a, uint n, void *f)
 28 bf8a59fa 2004-04-11 devnull .PP
 29 bf8a59fa 2004-04-11 devnull .B
 30 bf8a59fa 2004-04-11 devnull u16int	beload2(uchar *p)
 31 bf8a59fa 2004-04-11 devnull .br
 32 bf8a59fa 2004-04-11 devnull u32int	beload4(uchar *p)
 33 bf8a59fa 2004-04-11 devnull .br
 34 bf8a59fa 2004-04-11 devnull u64int	beload8(uchar *p)
 35 bf8a59fa 2004-04-11 devnull .PP
 36 bf8a59fa 2004-04-11 devnull .B
 37 bf8a59fa 2004-04-11 devnull u16int	leswap2(u16int u)
 38 bf8a59fa 2004-04-11 devnull .br
 39 bf8a59fa 2004-04-11 devnull u32int	leswap4(u32int u)
 40 bf8a59fa 2004-04-11 devnull .br
 41 bf8a59fa 2004-04-11 devnull u64int	leswap8(u64int u)
 42 bf8a59fa 2004-04-11 devnull .PP
 43 bf8a59fa 2004-04-11 devnull .B
 44 bf8a59fa 2004-04-11 devnull int	leieeeftoa32(char *a, uint n, void *f)
 45 bf8a59fa 2004-04-11 devnull .br
 46 bf8a59fa 2004-04-11 devnull int	leieeeftoa64(char *a, uint n, void *f)
 47 bf8a59fa 2004-04-11 devnull .br
 48 bf8a59fa 2004-04-11 devnull int	leieeeftoa80(char *a, uint n, void *f)
 49 bf8a59fa 2004-04-11 devnull .PP
 50 bf8a59fa 2004-04-11 devnull .B
 51 bf8a59fa 2004-04-11 devnull u16int	leload2(uchar *p)
 52 bf8a59fa 2004-04-11 devnull .br
 53 bf8a59fa 2004-04-11 devnull u32int	leload4(uchar *p)
 54 bf8a59fa 2004-04-11 devnull .br
 55 bf8a59fa 2004-04-11 devnull u64int	leload8(uchar *p)
 56 bf8a59fa 2004-04-11 devnull .PP
 57 bf8a59fa 2004-04-11 devnull .B
 58 bf8a59fa 2004-04-11 devnull int	ieeeftoa32(char *a, uint n, u32int u)
 59 bf8a59fa 2004-04-11 devnull .br
 60 bf8a59fa 2004-04-11 devnull int	ieeeftoa64(char *a, uint n, u32int hi, u32int lo)
 61 bf8a59fa 2004-04-11 devnull .SH DESCRIPTION
 62 bf8a59fa 2004-04-11 devnull These functions provide 
 63 bf8a59fa 2004-04-11 devnull machine-independent access to data in a particular byte order.
 64 bf8a59fa 2004-04-11 devnull .PP
 65 bf8a59fa 2004-04-11 devnull .IR Beswap2 ,
 66 bf8a59fa 2004-04-11 devnull .IR beswap4 ,
 67 bf8a59fa 2004-04-11 devnull and
 68 bf8a59fa 2004-04-11 devnull .I beswap8
 69 bf8a59fa 2004-04-11 devnull return the 2-byte, 4-byte, and 8-byte
 70 bf8a59fa 2004-04-11 devnull big-endian representation of the bytes in
 71 bf8a59fa 2004-04-11 devnull .IR val ,
 72 bf8a59fa 2004-04-11 devnull respectively.
 73 bf8a59fa 2004-04-11 devnull .PP
 74 bf8a59fa 2004-04-11 devnull .IR Beload2 ,
 75 bf8a59fa 2004-04-11 devnull .IR beload4 ,
 76 bf8a59fa 2004-04-11 devnull and
 77 bf8a59fa 2004-04-11 devnull .I beload8
 78 bf8a59fa 2004-04-11 devnull return the 2-byte, 4-byte, and 8-byte 
 79 bf8a59fa 2004-04-11 devnull big-endian interpretation of the bytes at
 80 bf8a59fa 2004-04-11 devnull .IR p ,
 81 bf8a59fa 2004-04-11 devnull respectively.
 82 bf8a59fa 2004-04-11 devnull .PP
 83 bf8a59fa 2004-04-11 devnull .IR Beieeeftoa32 ,
 84 bf8a59fa 2004-04-11 devnull .IR beieeeftoa64 ,
 85 bf8a59fa 2004-04-11 devnull and
 86 bf8a59fa 2004-04-11 devnull .I beieeeftoa80
 87 bf8a59fa 2004-04-11 devnull format the big-endian 4-byte, 8-byte, or 10-byte IEEE floating-point value
 88 bf8a59fa 2004-04-11 devnull at
 89 bf8a59fa 2004-04-11 devnull .IR f
 90 bf8a59fa 2004-04-11 devnull into the 
 91 bf8a59fa 2004-04-11 devnull .IR n -byte 
 92 bf8a59fa 2004-04-11 devnull string buffer
 93 bf8a59fa 2004-04-11 devnull .IR a .
 94 bf8a59fa 2004-04-11 devnull .PP
 95 bf8a59fa 2004-04-11 devnull .IR Leswap2 ,
 96 bf8a59fa 2004-04-11 devnull .IR leswap4 ,
 97 bf8a59fa 2004-04-11 devnull etc. are the little-endian equivalents of the routines just described.
 98 bf8a59fa 2004-04-11 devnull .PP
 99 bf8a59fa 2004-04-11 devnull .I Ieeeftoa32
100 bf8a59fa 2004-04-11 devnull and
101 bf8a59fa 2004-04-11 devnull .I ieeeftoa64
102 bf8a59fa 2004-04-11 devnull format a local machine byte-order floating-point value into the 
103 bf8a59fa 2004-04-11 devnull .IR n -byte
104 bf8a59fa 2004-04-11 devnull string buffer
105 bf8a59fa 2004-04-11 devnull .IR a .
106 bf8a59fa 2004-04-11 devnull .I Ieeeftoa32
107 bf8a59fa 2004-04-11 devnull expects a 32-bit floating-point value stored in the bits of
108 bf8a59fa 2004-04-11 devnull .IR u .
109 bf8a59fa 2004-04-11 devnull .I Ieeeftoa64
110 bf8a59fa 2004-04-11 devnull expects a 64-bit floating-point value whose high 32-bits are in 
111 bf8a59fa 2004-04-11 devnull .I hi
112 bf8a59fa 2004-04-11 devnull and low 32-bits are in
113 bf8a59fa 2004-04-11 devnull .IR lo .
114 bf8a59fa 2004-04-11 devnull .SH SOURCE
115 c3674de4 2005-01-11 devnull .B \*9/src/libmach
116 bf8a59fa 2004-04-11 devnull .SH "SEE ALSO"
117 d32deab1 2020-08-16 rsc .MR mach (3)