X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=original%2Fman3%2Fswab.3;h=e2cd629d9bcbfc19186a822f6fb8fd978e8de592;hb=4ea6bb24817f6f049d6bbc90ecd77a869876f9b0;hp=c131623eb7a2c8ad9e3f01046ddfbeaa6b1dc0db;hpb=633a2252e0be3c867dce264a180a89ce8181d36f;p=linuxjm%2FLDP_man-pages.git diff --git a/original/man3/swab.3 b/original/man3/swab.3 index c131623e..e2cd629d 100644 --- a/original/man3/swab.3 +++ b/original/man3/swab.3 @@ -1,5 +1,6 @@ .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" +.\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. @@ -19,6 +20,7 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .\" References consulted: .\" Linux libc source code @@ -26,12 +28,12 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 17:52:15 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2001-12-15, aeb -.TH SWAB 3 2001-12-15 "" "Linux Programmer's Manual" +.TH SWAB 3 2014-02-25 "" "Linux Programmer's Manual" .SH NAME swab \- swap adjacent bytes .SH SYNOPSIS .nf -.B #define _XOPEN_SOURCE +.BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */" .B #include .sp .BI "void swab(const void *" from ", void *" to ", ssize_t " n ); @@ -39,22 +41,49 @@ swab \- swap adjacent bytes .SH DESCRIPTION The .BR swab () -function copies \fIn\fP bytes from the array pointed -to by \fIfrom\fP to the array pointed to by \fIto\fP, exchanging +function copies +.I n +bytes from the array pointed +to by +.I from +to the array pointed to by +.IR to , +exchanging adjacent even and odd bytes. This function is used to exchange data between machines that have different low/high byte ordering. .LP -This function does nothing when \fIn\fP is negative. -When \fIn\fP is positive and odd, it handles \fIn\-1\fP bytes +This function does nothing when +.I n +is negative. +When +.I n +is positive and odd, it handles +.I n\-1 +bytes as above, and does something unspecified with the last byte. -(In other words, \fIn\fP should be even.) -.SH "RETURN VALUE" +(In other words, +.I n +should be even.) +.SH RETURN VALUE The .BR swab () function returns no value. -.SH "CONFORMING TO" +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR swab () +function is thread-safe. +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" -.BR bstring (3), -.BR feature_test_macros (7) +.SH SEE ALSO +.BR bstring (3) +.SH COLOPHON +This page is part of release 3.79 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%http://www.kernel.org/doc/man\-pages/.