


bsp_hpmove(3)           BSPlib FUNCTIONS            bsp_hpmove(3)



NAME
     bsp_hpmove - a lean method for moving a BSMP packet from the
     system queue.


C SYNOPSIS
     #include "bsp.h"

     int bsp_hpmove(void **_t_a_g__p_t_r__b_u_f,void **_p_a_y_l_o_a_d__p_t_r__b_u_f);


DESCRIPTION
     The operation bsp_hpmove is a non-copying method of  receiv-
     ing  messages  that  is available in languages with pointers
     such as C, but not vanilla Fortran. bsp_hpmove is a function
     which  returns  -1, if the system buffer is empty. Otherwise
     it returns the length of the payload of the first message in
     the buffer and:


     a)   places a pointer to the tag in _t_a_g__p_t_r__b_u_f;


     b)   places a pointer to the payload in _p_a_y_l_o_a_d__p_t_r__b_u_f;


     c)   removes the  message  from  from  the  incoming  system
          buffer.



SEE ALSO
     bsmp(3)  ,bsp_send(3),   bsp_set_tagsize(3),   bsp_qsize(3),
     bsp_get_tag(3), bsp_move(3)

     ``_A _p_r_o_p_o_s_a_l _f_o_r _t_h_e _B_S_P _W_o_r_l_d_w_i_d_e _S_t_a_n_d_a_r_d _L_i_b_r_a_r_y (_p_r_e_l_i_m_-
     _i_n_a_r_y  _v_e_r_s_i_o_n)''  Mark  W.  Goudreau,  Jonathan M. D. Hill,
     Kevin Lang, Bill McColl, Satish B. Rao, Dan  C.  Stefanescu,
     Torsten  Suel, Thanasis Tsantilas. Oxford University Comput-
     ing Laboratory, April 1996. See _h_t_t_p://_w_w_w._b_s_p-_w_o_r_l_d_w_i_d_e._o_r_g
     for more details.



BUGS
     Problems  and  bug  reports  should  be  mailed  to  _b_s_p_l_i_b-
     _b_u_g_s@_c_o_m_l_a_b._o_x._a_c._u_k


AUTHORS
     The Oxford BSP Toolset implementation of BSPlib was  written
     by Jonathan.Hill@comlab.ox.ac.uk



Oxford BSP Toolset  Last change: 1.4 25/9/98                    1






bsp_hpmove(3)           BSPlib FUNCTIONS            bsp_hpmove(3)



     http://www.comlab.ox.ac.uk/oucl/people/jonathan.hill.html






















































Oxford BSP Toolset  Last change: 1.4 25/9/98                    2



