Defect in XBD limits.h

[yyyyyyyy@xxxxxxxxxx]

        Defect report from : William Toth , IBM Austin

(Please direct followup comments direct to yyyyyyyyyyyyyy@xxxxxxxxxxxxx)

@ page 253 line 8871 section limits.h comment {WLT-XBD-5}

Problem:

Edition of Specification (Year): 2004

Defect code :  1. Error

The following are defined for the POSIX Advisory Information option.

ADV {POSIX_ALLOC_SIZE_MIN}
8871 Minimum number of bytes of storage actually allocated for any portion of a 
file.
8872 Minimum Acceptable Value: Not specified.
8873 ADV {POSIX_REC_INCR_XFER_SIZE}
8874 Recommended increment for file transfer sizes between the
8875 {POSIX_REC_MIN_XFER_SIZE} and {POSIX_REC_MAX_XFER_SIZE} values.
8876 Minimum Acceptable Value: Not specified.
8877 ADV {POSIX_REC_MAX_XFER_SIZE}
8878 Maximum recommended file transfer size.
8879 Minimum Acceptable Value: Not specified.
8880 ADV {POSIX_REC_MIN_XFER_SIZE}
8881 Minimum recommended file transfer size.
8882 Minimum Acceptable Value: Not specified.
8883 ADV {POSIX_REC_XFER_ALIGN}
8884 Recommended file transfer buffer alignment.
8885 Minimum Acceptable Value: Not specified.

This information doesn't seem to be sufficient to determine exactly what values 
an implementation should supply. None of the Advisory system calls descriptions 
describe using these variables, so it is not clear what effect or what use they 
might have in an application.

Action:

Add more information. And possibly, add examples on how to use these in an 
application.