From 9c6bb4da99d2b3bde16e16cf4616b4126a9cf419 Mon Sep 17 00:00:00 2001
From: Salvatore Filippone
Date: Mon, 28 Mar 2022 14:04:52 +0200
Subject: [PATCH] Document non-blocking collectives.
---
docs/html/userhtml29x.png | Bin 2411 -> 2410 bytes
docs/html/userhtmlsu65.html | 60 +-
docs/html/userhtmlsu66.html | 66 +-
docs/html/userhtmlsu67.html | 69 +-
docs/html/userhtmlsu68.html | 66 +-
docs/html/userhtmlsu69.html | 66 +-
docs/html/userhtmlsu70.html | 66 +-
docs/html/userhtmlsu71.html | 68 +-
docs/html/userhtmlsu72.html | 14 +-
docs/html/userhtmlsu73.html | 10 +-
docs/html/userhtmlsu90.html | 4 +
docs/psblas-3.7.pdf | 4845 +++++++++++++++++++----------------
docs/src/penv.tex | 156 +-
13 files changed, 3116 insertions(+), 2374 deletions(-)
diff --git a/docs/html/userhtml29x.png b/docs/html/userhtml29x.png
index 64db17ce3373ac7ff17870d9f0cc3b2c49b07a8f..b4efccdba0c997cc3e3ed2ec3574378695642b9c 100644
GIT binary patch
delta 2378
zcmV-Q3AOg?66z9=Ie#2UL_t(|0qvWMk<>U4hIh9JfZL1UmJE1A0A#R01P2*F5y2Ig
z0c3Co8NfxrBLm2QWi#0OKaJW*wrtBYGRz=#mBxCs+ERC`yCr#!udc3+8q9Ox`1ts#
zuwKk#)`uY-Iu2)jEiAPBBnR%R^*1r_auTaG9-TBEWOLxODSuQRubNV2@JX)ky3j5%
zP#cOk(3C1q4Q>nVQyyx=YD$%-12={CJ`c5FHKoeafjdHLmMV`|&HZKa=}bZTmrUI1
z(VC^IUIofCpefZ1Pqp(Sp87C@)|vwjG^GldF_LBH_i?1HRVO&mlq$iLUezs?J4+?Y
z^;zj^#q_xM{(pljHl>;u*=+^s;m$9-|KrMrtDEB`i9Sjw>jR}%O5rBpnaT$ZFyo*n
zu=e0(kv@t?C_o3Qd#%E`uXv|+?ge)O(S+V}C1SYyqWNwof`vM3T-+uwF5pb*i^evs
z_(C{pDa`}V#MdeQsO_^7E0Xjyg|khaXkiK8Zqs*-K7Sg^%aE?h#FtTB*iOE=KXGUR
zrcTmvT?Q|-qQTu6BowT`7tzBi>;pXR&F!TI^>AunO{u21b96L%k}lyBXN7J6mskWu
z`-uoGQYr}^;eS+O6S1i8%%C6mxf&Yoa2nL1xxWz}h;wh1u21pE
zc8(&soqtT#7iIi5)nDznzZX+D%~FX&6Oi)_6>gASAaIVw*kpgoFB^(o0(>?L7h@y$
zbGwj2g%)~%-jr&
zI=j)1Z4i%!$_z38c1AxUu7STdT;Jp#rJ>j`U;Kz)z
zFn?~~k?OEU#E0*cryf~8^Lb=TJ9N^Zjx@M)7Cjjt=OpL8K01?7J@EoKUGS6@_6L&t8P_LFNnT15+17+8V*NgCXBBS
zuQya2f^eaa+gSpbWgGvJesj3dyylQ;XB?UX*2D2k&(|vdVY~omR}eiE7lrTS0DaX%
zx^rE*cy#iRjHg7KE2YJ7QyuAKtIU_`7{l|lKZotAW8w0yPIkF?Mo0Kqq{mj?<=HU}f)E}frZxsW
zc|Ku%g~v)YrZU)7+8W^i$)-dQVQLL?9iH+|^J~dwE(YcbP?^a)D_4O?3`k|+UMTy3yGP1MH7Jmyk3(w{y
zd=#b&zLg(%B-LeGu@fO%5Y9lR&N%*3d$j8OieLb?jYZ=TNC@;kQr}!*jj9|2Qk9HeBKR@70@}XiizN
zGxg)n(aGL@Po)CZC)u?hgUoz;_XYdUkNb{NW_jG0bRg=0#mru_%aWAF`C
z&ZyOo%?@t!&yX)UeRFaAJCK739{$5~7B4Q$E#O={^)aIYO)M7IFriG*4d!)2^@KG8
z(7TW`^XC1xxZW?2Gt$%1D#M9+H%lFV&h^hDvpN)XU)TtM7wYQ1Il&K5*JuWY{#P`
zkN*7Co_+iwTo}%FK6|^}e_y{WS}16AV&2F3k!9wlge7M2WF3)&ho9>6>w*NqN{hDR
z{n@IWVEdw9pDGI%;lph1;6}IGslH=%qKV+J2742i`ME7}>wi@!l^A2^Z@4u+OJT)b
zCWK48H5*TP$WqHxRO1eT*vTObveX!T97QZ;mZlWxMknAvRZ8XO
zjkUu4MIg6^qM0R&+FD^52WnI*;;QR@=M{2`Al(A_u)gINa-c?~GR5gzD}wZ9sTL|w
z3cW_9GR48&g@C29-CX_dJ?dDi
zQd#_jg?|G0%ahe@YRdi2el=O{Rr^7yN~MwlnN_;uT_Aybaqux!&R3Jg-~BTQR;g5;
z;aH|KpX}_av@B3w{;kZ%cl>X%3aEAWhj0-%2a@ap?UY^Fa^PKRbze2qZmG~9zPen?
zQkB!t1EN&3QrQlWAl+iD0}|c-4z*^bGDTWz*F(3zQeSyw)hbnRgkZ|GGOOz$U#(Jk
w5o4vy4b~&|m1kPJQema+?^`Rgx*qcX1BZf_QdUv4B>(^b07*qoM6N<$f__t$O8@`>
delta 2379
zcmV-R3AFa=66+F>Ie#5VL_t(|0qvZNaTGZahHZ)fI9~*3GT;#bkbyZzaF78M5nMqA
zz7Wo202cv|3~&Y*XW;ukt$L7lMl+gSjoG!-Roc;`)g!f9{gB2!yuQ9ZXfVxz!^6W@
z!g@Q6Ss#XE=rEl1-LTN|qa1jq*5Aayt5K}hcyOojAe#e6O@E;Bc-4d|gHJMj_k?zt
zf!a{SfhJUWV(>_4U-M8KRuif`8F(PHPkE>fs|i(}3_KQE(^Pr9YUVGKPsei7FEVkf
zM{Am@dJ!nkfF@KEJXPd}KlOP6tu+T6XhIb*BatQY`;usD)dL)8LN&mYwW^0IcbZC?
z>zmT`g6YND`+xVY*o10&$sWl`4E^Jtk0GHQ3`{A*DCKdz>K|~
zz|w=4M*1QiApjky?p%cvU-41x+zW06q6xh>O89WkMDycT1PgW6xVTMVT)?r?g~m26
z_(C{nX_yC|iRVN7QQJ2qb|mT55Y8rbqJ<{>uu0z~`hRFFXCYmc@h_vgu$_D}f8x*x
zjGd%ox(wcGM}xaHXi?At7ovw&*adj8Hn%ek>d&!(HK7{g&cQ+QBwdS-pB0(`Okxob
z?Uy1nOQ^K)EdCcIf{0mtCkFl8&(+W{hvT3Q&HN>JAkKYIx;Mrnk7H(V&{U4~FWIKC
z5IKtEW`Ap{z6j%wvHohu{JkB+X_`tL8iAZ|s4#;>fxrnGW0n0SzXTN9IQRq$m#LBa
zxm`-2LJi$RZ$i~$$*MvOM9n7|Y~93Q1S<5e&I+3!dsWU8UkB~FDG@sRBc41
zlaX!{sxtk-8bsK)2T4HjeqVt;iP_7dat_fa87O5UDO{T_3ug;@kkvChsklaL4OCrd1v`O
zd5%SXy(wsZFEwu#1^zrx9={{vORv)w6{64haOhbF0FB97L>plM@4e8T3eRl%
zIqB3Xg>xc58j#$T^da%4iH?*<7)%POM}Hs=JRW)Ms@oOR3!-n0gvV}$hQm>r31jQS
z>kSqAAYABUcIE(T*~UMo-xO{%uPJ2O8HeV8_HaDY^IYXWj2GZ+3!;bMBJkZhKwtHc
z?o3xM9-TZ4`ctCKmC|f@ppJC1UFOQvg-Pvb9}tmfOG8=;p>oo!Cp)FnSRuV#&wp#&
zT+c*2$Stcciw+M+k@m=?k;3z|zlH6pW8?C!ZtZgMjE?ZpNH46s&9h?~1RF@Km~H1kHF`D2d$
zRcAI6d@Tarq(Q4QbDnUtcDZ=LpqTHK##+XW5Fw|nM08aBrP@``t~3*hP((XZWdv(u
zQ)1)0$*0E4JUUY{_ucC2w7#B2O+WOM&?wQ^RA%ig*kS``;n}=|kGbxgZ-3=`7Rlqd
z0M7cQo_B<7PB;S@JLC9U?a{9DJAwgN7>mTSAR*9avCukvQNjHBH&ofA#S?r=c<@Ag
zxytUCf#~VMYxwLy@58?Z2ohMs?-O`m4bS!Z`Qx;d+AxKmepYw6*P?3yTvtg(eU6p5
zb98I(zNb>6?q=-@!WA!oz=f&gR90xec6)r#_}spozxf8m3!Q+NVJ8Vx5^c?|)d;
zM|zq(KF*jncDqi@LHmYRFH?M_pD`9EdfyIulk?NOP&jOs`&R*g_;!WLxQ?{OrqU@(Rq2wLiK9%P
zCuyvCEuu;Ecr>rqqJP+oXFUL0e<6|K$`@0nI{>|{dCeXz#ZDp|kB&Un=dAYZ;}7BD
zZxGHGIW%M}0t7TVF<&3!O_ntl=ID5)XYZ(CXe`xeDoq~M9EIa5M<5M>vway=CJMr3
z@iBYF?jF6?BZ`_8eIdZ9;|l1AkIC2b14WNsG+YOsh9m^jnRi&YDUfuJj<8rlGn)VGdL!RGxQeE6iU6
zGHVE$X|kxT73OiEMxny5y5}RWkXtzE=E#TjEkBb3H42pp&bqe3NpG5JrT`70*CN?9McZTylQ?O3Z&ng4`_
z0{D|BtAAV7l>5#3z^&Zdc7RfqLL~t*t@PNNKpgkt;C(9odoh1LWq*lO{5`uyuu7rw
zi-2Z2_Q}q!O0N&XJL?0t(gXMv^lFX%;57@*fh19&ow6%i4!lXN?yH8{H5C%XSC>m^
zs&W##N0e$7DvJPd(#^-(qov#3q1G%^CP+&~eMGyv>I;voTA}j(4(v7ITA0=Kkgry#
x{1T(3%na7E>I=`bcA-K`*`IGM%<6i`{|^}P1+hBG9!&rM002ovPDHLkV1hZ$k&FNU
diff --git a/docs/html/userhtmlsu65.html b/docs/html/userhtmlsu65.html
index fe8ce35d..593e3b58 100644
--- a/docs/html/userhtmlsu65.html
+++ b/docs/html/userhtmlsu65.html
@@ -22,7 +22,7 @@ href="userhtmlsu59.html#userhtmlsu68.html" >up]
-call psb_bcast(ctxt, dat, root)
+call psb_bcast(ctxt, dat, root [, mode, request])
This subroutine implements a broadcast operation based on the underlying
@@ -74,8 +74,41 @@ class="newline" />Specified as: an integer value 0 <= root <= np - 1, default 0
-
+class="cmsy-10">- 1, default 0
+
+mode Whether the call is started in non-blocking mode and completed later,
+ or is executed fully.
Scope: global.
Type: optional.
Intent: in.
Specified as: an integer, with the value determined by the bitwise OR of
+ psb_collective_start_, psb_collective_end_. Default: both fields are
+ selected.
+
+
+
+
+request A request variable to check for operation completion.
Scope: local.
Type: optional.
Intent: inout.
If mode does not specifies immediate completion, then this variable must
+ be present.
+
-
On Return
-
-
dat
- On processes other than root, the data to be broadcast.
On all processes other than root, the broadcasted data.
Scope: global.
Type: Intent: inout.
Specified as: an integer, real or complex variable, which may be a scalar,
or a rank 1 or 2 array, or a character or logical scalar. Type, kind, rank
- and size must agree on all processes.
+ and size must agree on all processes.
+
+request A request variable to check for operation completion.
Scope: local.
Type: optional.
Intent: inout.
If mode does not specifies immediate completion, then this variable must
+ be present.
-