diff --git a/functions/dio.xml b/functions/dio.xml index c5cdbca9f5..d5ffea8300 100644 --- a/functions/dio.xml +++ b/functions/dio.xml @@ -1,5 +1,5 @@ - + Direct IO functions DIO functions @@ -236,7 +236,7 @@ dio_fcntl - Perform a c library fcntl on fd + Performs a c library fcntl on fd Description @@ -257,11 +257,40 @@ additional arguments args to be supplied. - cmd can be one of the following - operations: + arg is an associative array, when + cmd is F_SETLK or F_SETLLW, with the + following keys: + + "start" - offset where lock begins + "length" - size of locked area. zero means to + end of file + "wenth" - Where l_start is relative to: can be + SEEK_SET, SEEK_END and SEEK_CUR + "type" - type of lock: can be F_RDLCK (read + lock), F_WRLCK (write lock) or F_UNLCK (unlock) + - cmd parameters still undocumented. + cmd can be one of the following + operations: + + F_SETLK - Lock is set or cleared. If the lock + is held by someone else dio_fcntl returns + -1. + F_SETLKW - like F_SETLK, but in case the lock + is held by someone else, dio_fcntl waits + until the lock is released. + F_GETLK - dio_fcntl + returns an associative array (as described above) if someone + else prevents lock. If there is no obstruction key "type" + will set to F_UNLCK. + F_DUPFD - finds the lowest numbered available + file descriptor greater or equal than + arg and returns them. + + + +