close (dataSock);    if (nBytes &lt; 0)             /* read error? */        status = ERROR;    if (ftpReplyGet (ctrlSock, TRUE) != FTP_COMPLETE)        status = ERROR;    if (ftpCommand (ctrlSock, "QUIT", 0, 0, 0, 0, 0, 0) != FTP_COMPLETE)        status = ERROR;    close (ctrlSock);</pre></blockquote><h4>RETURNS</h4><blockquote><p><p>OK, or ERROR if any socket cannot be created or if a connection cannot bemade.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b>, <b><i><a href="./ftpLib.html#ftpReplyGet">ftpReplyGet</a></i>(&nbsp;)</b><hr><a name="ftpReplyGet"></a><p align=right><a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p></blockquote><h1><i>ftpReplyGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  <p><strong><i>ftpReplyGet</i>(&nbsp;)</strong> - get an FTP command reply</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int ftpReplyGet    (    int  ctrlSock, /* control socket fd of FTP connection */    BOOL expecteof /* TRUE = EOF expected, FALSE = EOF is error */    )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine gets a command reply on the specified control socket.All the lines of a reply are read (multi-line replies areindicated with the continuation character "-" as the fourth characterof all but the last line).<p>The three-digit reply code from the first line is saved and interpreted.The left-most digit of the reply code identifies the type of code(see RETURNS below).<p>The caller's error status is set to the complete three-digit reply code(see the manual entry for <b><i><a href="./errnoLib.html#errnoGet">errnoGet</a></i>(&nbsp;)</b>).If the reply code indicates an error, the entire replyis printed on standard error.<p>If an EOF is encountered on the specified control socket, but no EOF wasexpected (<i>expecteof</i> == FALSE), then ERROR is returned.<p></blockquote><h4>RETURNS</h4><blockquote><p><p>&nbsp;1&nbsp;=&nbsp;<b>FTP_PRELIM</b>&nbsp;(positive&nbsp;preliminary)<br>&nbsp;2&nbsp;=&nbsp;<b>FTP_COMPLETE</b>&nbsp;(positive&nbsp;completion)<br>&nbsp;3&nbsp;=&nbsp;<b>FTP_CONTINUE</b>&nbsp;(positive&nbsp;intermediate)<br>&nbsp;4&nbsp;=&nbsp;<b>FTP_TRANSIENT</b>&nbsp;(transient&nbsp;negative&nbsp;completion)<br>&nbsp;5&nbsp;=&nbsp;<b>FTP_ERROR</b>&nbsp;(permanent&nbsp;negative&nbsp;completion)<p>ERROR if there is a read/write error or an unexpected EOF.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b><hr><a name="ftpHookup"></a><p align=right><a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p></blockquote><h1><i>ftpHookup</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  <p><strong><i>ftpHookup</i>(&nbsp;)</strong> - get a control connection to the FTP server on a specified host</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int ftpHookup    (    char * host /* server host name or inet address */    )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine establishes a control connection to the FTP server on thespecified host.  This is the first step in interacting with a remote FTPserver at the lowest level.  (For a higher-level interaction with a remoteFTP server, see the manual entry for <b><i><a href="./ftpLib.html#ftpXfer">ftpXfer</a></i>(&nbsp;)</b>.)<p></blockquote><h4>RETURNS</h4><blockquote><p><p>The file descriptor of the control socket, or ERROR if the Internetaddress or the host name is invalid, if a socket could not be created, orif a connection could not be made.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b>, <b><i><a href="./ftpLib.html#ftpLogin">ftpLogin</a></i>(&nbsp;)</b>, <b><i><a href="./ftpLib.html#ftpXfer">ftpXfer</a></i>(&nbsp;)</b><hr><a name="ftpLogin"></a><p align=right><a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p></blockquote><h1><i>ftpLogin</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  <p><strong><i>ftpLogin</i>(&nbsp;)</strong> - log in to a remote FTP server</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS ftpLogin    (    int    ctrlSock, /* fd of login control socket */    char * user,     /* user name for host login */    char * passwd,   /* password for host login */    char * account   /* account for host login */    )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine logs in to a remote server with the specified user name,password, and account name, as required by the specific remote host.  Thisis typically the next step after calling <b><i><a href="./ftpLib.html#ftpHookup">ftpHookup</a></i>(&nbsp;)</b> in interacting with aremote FTP server at the lowest level.  (For a higher-level interactionwith a remote FTP server, see the manual entry for <b><i><a href="./ftpLib.html#ftpXfer">ftpXfer</a></i>(&nbsp;)</b>).<p></blockquote><h4>RETURNS</h4><blockquote><p><p>OK, or ERROR if the routine is unable to log in.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b>, <b><i><a href="./ftpLib.html#ftpHookup">ftpHookup</a></i>(&nbsp;)</b>, <b><i><a href="./ftpLib.html#ftpXfer">ftpXfer</a></i>(&nbsp;)</b><hr><a name="ftpDataConnInit"></a><p align=right><a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p></blockquote><h1><i>ftpDataConnInit</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  <p><strong><i>ftpDataConnInit</i>(&nbsp;)</strong> - initialize an FTP data connection</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int ftpDataConnInit    (    int ctrlSock /* fd of associated control socket */    )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine sets up the client side of a data connection for thespecified control connection.  It creates the data port, informs theremote FTP server of the data port address, and listenson that data port.  The server will then connect to this data portin response to a subsequent data-transfer command sent on thecontrol connection (see the manual entry for <b><i><a href="./ftpLib.html#ftpCommand">ftpCommand</a></i>(&nbsp;)</b>).<p>This routine must be called <i>before</i> the data-transfer command is sent;otherwise, the server's connect may fail.<p>This routine is called after <b><i><a href="./ftpLib.html#ftpHookup">ftpHookup</a></i>(&nbsp;)</b> and <b><i><a href="./ftpLib.html#ftpLogin">ftpLogin</a></i>(&nbsp;)</b> to establish aconnection with a remote FTP server at the lowest level.  (For ahigher-level interaction with a remote FTP server, see <b><i><a href="./ftpLib.html#ftpXfer">ftpXfer</a></i>(&nbsp;)</b>.)<p></blockquote><h4>RETURNS</h4><blockquote><p>The file descriptor of the data socket created, or ERROR.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b>, <b><i><a href="./ftpLib.html#ftpHookup">ftpHookup</a></i>(&nbsp;)</b>, <b><i><a href="./ftpLib.html#ftpLogin">ftpLogin</a></i>(&nbsp;)</b>, <b><i><a href="./ftpLib.html#ftpCommand">ftpCommand</a></i>(&nbsp;)</b>, <b><i><a href="./ftpLib.html#ftpXfer">ftpXfer</a></i>(&nbsp;)</b><hr><a name="ftpDataConnGet"></a><p align=right><a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p></blockquote><h1><i>ftpDataConnGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  <p><strong><i>ftpDataConnGet</i>(&nbsp;)</strong> - get a completed FTP data connection</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int ftpDataConnGet    (    int dataSock /* fd of data socket on which to await connection */    )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine completes a data connection initiated by a call to<b><i><a href="./ftpLib.html#ftpDataConnInit">ftpDataConnInit</a></i>(&nbsp;)</b>.  It waits for a connection on the specified socket fromthe remote FTP server.  The specified socket should be the one returned by<b><i><a href="./ftpLib.html#ftpDataConnInit">ftpDataConnInit</a></i>(&nbsp;)</b>.  The connection is established on a new socket, whosefile descriptor is returned as the result of this function.  The original socket, specified in the argument to this routine, is closed.<p>Usually this routine is called after <b><i><a href="./ftpLib.html#ftpDataConnInit">ftpDataConnInit</a></i>(&nbsp;)</b> and <b><i><a href="./ftpLib.html#ftpCommand">ftpCommand</a></i>(&nbsp;)</b> toinitiate a data transfer from/to the remote FTP server.<p></blockquote><h4>RETURNS</h4><blockquote><p><p>The file descriptor of the new data socket, or ERROR if the connectionfailed.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b>, <b><i><a href="./ftpLib.html#ftpDataConnInit">ftpDataConnInit</a></i>(&nbsp;)</b>, <b><i><a href="./ftpLib.html#ftpCommand">ftpCommand</a></i>(&nbsp;)</b><hr><a name="ftpLs"></a><p align=right><a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p></blockquote><h1><i>ftpLs</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  <p><strong><i>ftpLs</i>(&nbsp;)</strong> - list directory contents via FTP</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS ftpLs    (    char * dirName /* name of directory to list */    )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine lists the contents of a directory.  The content listis obtained via an NLST FTP transaction.<p>The local device name must be the same as the remote host namewith a colon ":" as a suffix.  (For example "wrs:" is the devicename for the "wrs" host.)<p></blockquote><h4>RETURNS </h4><blockquote><p>OK, or ERROR if could not open directory.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ftpLib.html#top">ftpLib</a></b></body></html>