send_file 子例程

/*
 * Structure for the send_file system call
 */
#ifdef __64BIT__
#define SF_INT64(x)     int64_t x;
#define SF_UINT64(x)    uint64_t x;
#else
#ifdef _LONG_LONG
#define SF_INT64(x)     int64_t x;
#define SF_UINT64(x)    uint64_t x;
#else
#define SF_INT64(x)     int filler_##x; int x;
#define SF_UINT64(x)    int filler_##x; uint_t x;
#endif
#endif

struct sf_parms {
    /* --------- header parms ---------- */
    void      *header_data;         /* Input/Output. Points to header buf */
    uint_t      header_length;      /* Input/Output. Length of the header */
    /* --------- file parms ------------ */
    int       file_descriptor;      /* Input. File descriptor of the file */
    SF_UINT64(file_size)            /* Output. Size of the file */
    SF_UINT64(file_offset)          /* Input/Output. Starting offset */
    SF_INT64(file_bytes)            /* Input/Output. number of bytes to send */
    /* --------- trailer parms --------- */
   void      *trailer_data;         /* Input/Output. Points to trailer buf */
   uint_t    trailer_length;        /* Input/Output. Length of the trailer */
    /* --------- return info ----------- */
    SF_UINT64(bytes_sent)           /* Output. number of bytes sent */
};

头数据

指向一个缓冲区，该缓冲区包含要在文件数据之前发送的头数据。 0 头长度 为 0 ，那么可能是 NULL 指针。 此字段将由 send_file 在传输头时进行更新-即，header_data+ 发送的头的字节数。

头长度

指定 头数据中的字节数。 0 将此字段设置为 0 ，以指示不发送头数据。 此字段将由 send_file 在传输头时进行更新-即，header_length-发送的头的字节数。

文件描述符

指定已打开的文件的文件描述符，并且该文件是可读的。 这是包含所要传输的数据的文件的描述符。 当 file_bytes = 0 时，将忽略 file_descriptor 。 此字段未由 send_file更新。

文件大小

包含由 file_descriptor指定的文件的字节大小。 此字段是由内核填充的。

文件偏移量

指定要从其开始发送数据的文件中的字节偏移量。 在传输文件数据时， send_file 将更新此字段-即，file_offset+ 发送的文件数据的字节数。

文件字节数

指定从要传输的文件中发送的字节数。 将file_bytes设置为-1会从file_offset 开始传输整个文件。 当该字段未设置为-1 时，文件数据传输时，send_file会更新该字段、file_bytes-发送的文件数据的字节数。

Trailer_data

指向一个缓冲区，该缓冲区包含要在文件数据之后发送的尾部数据。 0 Trailer_length 为 0 ，那么可能是 NULL 指针。 此字段将由 send_file 在传输尾部时进行更新-即，trailer_data+ 发送的尾部的字节数。

Trailer_length

指定 Trailer_data中的字节数。 必须将此字段设置为 0 ，以指示不发送尾部数据。 此字段将由 send_file 在传输尾部时进行更新-即，trailer_length-发送的尾部的字节数。

发送字节数

包含在此调用中实际发送到 send_file的字节数。 此字段是由内核填充的。

所有字段标记为Input在 sf_parms 结构中，需要由应用程序在 send_file 调用之前进行设置。 所有字段标记为Output在 sf_parms 结构中， send_file 在成功传输数据时进行调整，即指定的数据传输已部分完成或完全完成。

send_file 子例程尝试从 头数据指向的缓冲区中写入 头长度 个字节，然后从与 file_descriptor关联的文件中写入 file_bytes ，再从 Trailer_data指向的缓冲区中写入 Trailer_length 个字节，通过与 Socket_p指向的套接字关联的连接。

在发送数据时，内核会更新 sf_iobuf 指定的参数，以便在必须多次调用 send_file (由于信号中断或由于非阻塞 I/O 方式) 以完成文件数据传输时，应用程序可以重新发出 send_file 命令而不进行设置或反复重新调整这些参数。

如果应用程序设置的file_offset大于实际文件大小，或file_bytes大于（实际文件大小 - file_offset），返回值将是-1和 errno EINVAL。

SF_CLOSE

在数据成功发送或排队等待传输后，关闭 Socket_p 所指向的套接字。

SF_REUSE

在成功发送数据或排队等待传输并关闭现有连接后，准备重新使用该套接字。

注: 此选项当前在此操作系统上不受支持。

SF_DONT_CACHE

未将指定的文件放入网络缓冲区高速缓存中。

SF_SYNC_CACHE

在传输之前验证/更新指定文件的网络缓冲区高速缓存。

如果设置了 SF_CLOSE 标志，那么在成功完成所请求的传输后， send_file 将断开并关闭 Socket_p 指定的已连接套接字。 Socket_p指向的套接字描述符将被设置为-1。 如果send_file返回值non-0，该标记将不起作用。

AIX 目前不支持SF_REUSE标志。 指定此标志后，Socket_p指向的套接字将被关闭，并以-1 返回。 需要为下一个连接创建一个新套接字。

send_file 将利用内核内存中的网络缓冲区高速缓存来对输出文件数据进行动态高速缓存。 对于以下文件，这将有助于提高 send_file 的性能:

1. 重复地通过网络和
2. 不频繁更改。

通过使用 SF_DONT_CACHE 标志，应用程序可以将指定的文件排除在高速缓存之外。 send_file 将每隔一段时间更新一次高速缓存，以确保高速缓存中的文件数据在某个时间段内有效。 可以修改 不 命令控制的网络选项参数 "send_file_duration" 以配置 send_file 高速缓存验证的时间间隔，缺省值为 300 (以秒为单位)。 应用程序可以使用 SF_SYNC_CACHE 标志来确保在 send_file发送指定文件之前对该文件进行高速缓存验证，而不考虑 "send_file_duration" 的值。 其他网络缓冲区高速缓存相关参数为 "nbc_limit" ， nbc_max_cache "和 nbc_min_cache"。 要获取其他信息，请参阅 不 命令。