file_pread_ifmod

Name

file_pread_ifmod

Auth

yes

Description

Same as file_pread, but additionally expects sha1 or md5 parameter (hex).

If the checksum of the data to be read matches the sha1 or md5 checksum, it returns error code 6000 Not modified.

This call is useful if the application has the data cached and wants to verify if it still current.

You can see how to read data here.

Output

Returns the data.

Required

Parameter	Description
fd	int the file descriptor, from which data is read
count	int count in bytes, which to be read from the descriptor
offset	int in bytes, from where to start reading in the file
sha1	string the SHA-1 checksum of the part of the file from the offset, to be checked
md5	string the MD5 checksum of the part of the file from the offset, to be checked

Use sha1 or md5, but not both.

Errors

Code	Description
1000	Log in required.
1007	Invalid or closed file descriptor.
1009	Please provide 'offset'.
1011	Please provide 'count'.
2000	Log in failed.
4000	Too many login tries from this IP address.
5004	Read error. Try reopening the file.
6000	Not modified