1
1
openmpi/oshmem/shmem/man/man3/shmem_int_inc.3in
Igor Ivanov ea7c86c9b4 oshmem: Add man3 pages
These man pages to OpenSHMEM API are received from openshmem.org
and ported with minimum modifications.
Thanks Tony Curtis for sharing man files.

Signed-off-by: Igor Ivanov <Igor.Ivanov@itseez.com>
2015-08-25 12:52:35 +03:00

74 строки
1.6 KiB
Plaintext

.\" -*- nroff -*-
.\" Copyright (c) 2015 University of Houston. All rights reserved.
.\" Copyright (c) 2015 Mellanox Technologies, Inc.
.\" $COPYRIGHT$
.de Vb
.ft CW
.nf
..
.de Ve
.ft R
.fi
..
.TH "SHMEM\\_INC" "3" "#OMPI_DATE#" "#PACKAGE_VERSION#" "#PACKAGE_NAME#"
.SH NAME
\fIshmem_int4_inc\fP(3),
\fIshmem_int8_inc\fP(3),
\fIshmem_int_inc\fP(3),
\fIshmem_long_inc\fP(3),
\fIshmem_longlong_inc\fP(3)
\- These routines perform an atomic increment operation on a remote data object.
.SH SYNOPSIS
C or C++:
.Vb
#include <mpp/shmem.h>
int shmem_int_inc(int *target, int pe);
long shmem_long_inc(long *target, int pe);
long long shmem_longlong_inc(long long *target, int pe);
.Ve
Fortran:
.Vb
INCLUDE "mpp/shmem.fh"
INTEGER pe
INTEGER(KIND=4) SHMEM_INT4_INC, target4
INTEGER(KIND=8) SHMEM_INT8_INC, target8
ires4 = SHMEM_INT4_INC(target4, pe)
ires8 = SHMEM_INT8_INC(target8, pe)
.Ve
.SH DESCRIPTION
The atomic increment routines replace the value of \fBtarget\fP
with its value incremented by
one. The operation must be completed without the possibility of another process updating
\fBtarget\fP
between the time of the fetch and the update.
.PP
The arguments are as follows:
.TP
target
The remotely accessible integer data object to be updated on the remote PE. The
type of target should match that implied in the SYNOPSIS section.
.TP
pe
An integer that indicates the PE number upon which target is to be updated. If you
are using Fortran, it must be a default integer value.
.PP
.SH NOTES
The term remotely accessible is defined in \fIintro_shmem\fP(3)\&.
.SH RETURN VALUES
None.
.SH SEE ALSO
\fIintro_shmem\fP(3)