postToHost            package:httpRequest            R Documentation

_S_e_n_d_s _M_u_l_t_i_f_o_r_m _P_o_s_t _R_e_q_u_e_s_t _t_o _H_T_T_P _S_e_r_v_e_r

_D_e_s_c_r_i_p_t_i_o_n:

     Sends Multiform Post Request to HTTP Server

_U_s_a_g_e:

     postToHost(host, path, data.to.send, referer="", port=80)

_A_r_g_u_m_e_n_t_s:

    host: The host to which to send the Request e. g.: www.spiegel.de,
          127.0.0.1

    path: The path to the file e. g. /cgi/getpasswords.pl or
          /index.html

data.to.send: is a list of name value pairs e. g. list(name=value,
          name1=value1, name2=value2).  The value may be a
          list("filename"=X, "object"=Y), where Y is a vector of type
          raw and X is a name to be posted as the filename of Y.

 referer: something like www.myhome.org

    port: its 80 or 8080 most frequently

_D_e_t_a_i_l_s:

     It is a simple http client. So it does not take care of special
     chars e.g. whitspaces. For details see e.g. perl
     HTTP::Request::Common documentation. and
     'http://www.w3.org/Protocols/rfc1341/0_TableOfContents.html'

_V_a_l_u_e:

     document which the server returns.

_A_u_t_h_o_r(_s):

     E.W.Wolski wolski@molgen.mpg.de, Andreas Westfeld
     westfeld@inf.tu-dresden.de

_S_e_e _A_l_s_o:

     getToHost, simplePostToHost

_E_x_a_m_p_l_e_s:

     #to test uncomment. First check that the host ist running.
     #port <- 80
     #test2 <- list(
     #       "fruit"="apple",
     #       "dat_defs"="20021204/F113213.dat",
     #       "myimage"=list(
     #                       "filename"="myimage.raw",
     #                       "object"=as.raw(as.vector(mymatrix))
     #               ),
     #       "upsa"="test"
     #)
     #postToHost("www.molgen.mpg.de", "/~wolski/test.php4", test2, referer="www.test.de", port=port)

