Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

PR_TransmitFile

Sends a complete file across a connected socket.

Syntax

#include <prio.h> 

PRInt32 PR_TransmitFile(
  PRFileDesc *networkSocket, 
  PRFileDesc *sourceFile,
  const void *headers, 
  PRInt32 hlen, 
  PRTransmitFileFlags flags,
  PRIntervalTime timeout);

Parameters

The function has the following parameters:

networkSocket
A pointer to a PRFileDesc object representing the connected socket to send data over.
sourceFile
A pointer to a PRFileDesc object representing the file to send.
headers
A pointer to the buffer holding the headers to be sent before sending data.
hlen
Length of the headers buffer in bytes.
flags
One of the following flags:
  • PR_TRANSMITFILE_KEEP_OPEN indicates that the socket will be kept open after the data is sent.
  • PR_TRANSMITFILE_CLOSE_SOCKET indicates that the connection should be closed immediately after successful transfer of the file.
timeout
Time limit for completion of the transmit operation.

Returns

  • A positive number indicates the number of bytes successfully written, including both the headers and the file.
  • The value -1 indicates a failure. If an error occurs while sending the file, the PR_TRANSMITFILE_CLOSE_SOCKET flag is ignored. The reason for the failure can be obtained by calling PR_GetError.

Description

The PR_TransmitFile function sends a complete file (sourceFile) across a connected socket (networkSocket). If headers is non-NULL, PR_TransmitFile sends the headers across the socket before sending the file.

The enumeration PRTransmitFileFlags, used in the flags parameter, is defined as follows:

typedef enum PRTransmitFileFlags {
  PR_TRANSMITFILE_KEEP_OPEN = 0,
  PR_TRANSMITFILE_CLOSE_SOCKET = 1
} PRTransmitFileFlags;

Document Tags and Contributors

 Contributors to this page: teoli, Rappo
 Last updated by: teoli,