Setup and utility functions¶

new({ options... })

Creates a new File::RsyncP::FileIO object. The single argument is a hashref of options:

blockSize($value)

Set the block size to the new value, in case it wasn't set via the blockSize option to new().

checksumSeed($seed)

Set the checksum seed used in digest calculations to the new value. Usually this value isn't known when new() is called, so it is necessary to set it later via this function.

logHandlerSet

Set the log handler callback function. Usually this value is specified via new(), but it can be changed later via this function.

dirs($localDir, $remoteDir)

Specify the local and remote directories.

log(@msg)

Save one (or more) messages for logging purposes.

statsGet

Return an optional hashref of statistics compiled by the FileIO object. These values are opaquely passed up to File::RsyncP.

finish($isChild)

Do any necessary finish-up processing. The $isChild argument is true if this is the child process (remember the receiving side has two processes: the child receives the file deltas while the parent generates the block digests).

Checksum computation functions¶

csumStart($f, $needMD4)

Get ready to generate block checksums for the given file. The argument is a hashref typically returned by File::RsyncP::FileList->get. Typically this opens the underlying file and creates a File::RsyncP::Digest object. If $needMD4 is non-zero, then csumEnd() will return the file MD4 digest.

csumGet($num, $csumLen, $blockSize)

Return $num bkocks work of checksums with the MD4 checksum length of $csumLen (typically 2 or 16), with a block size of $blockSize. Typically this reads the file and calls File::RsyncP::Digest->blockDigest.

csumEnd()

Finish up the checksum calculation. Typically closes the underlying file. Note that csumStart, csumGet, csumEnd are called in strict order so they don't need to be reentrant (ie: there is only one csum done at a time). If csumStart() was called with $needMD4 then csumEnd() will return the file MD4 digest.

File reading functions¶

There are used for sending files (currently sending files doesn't implement deltas; it behaves as though --whole-file was specified):

readStart($f)

Get ready to read the given file. The argument is a hashref typically returned by File::RsyncP::FileList->get. Typically this opens the underlying file.

read($num)

Read $num bytes from the file.

readEnd()

Finish up the read operation. Typically closes the underlying file. Note that readStart, readGet, readEnd are called in strict order so they don't need to be reentrant (ie: there is only one read done at a time).

File operations¶

attribGet($f)

Return the attributes for the given file as a hashref. The argument is a hashref typically returned by File::RsyncP::FileList->get.

attribSet($f, $placeHolder)

Set the attributes for the given file. The argument is a hashref typically returned by File::RsyncP::FileList->get. If $placeHolder is true then don't do anything. Returns undef on success.

makePath($f)

Create the directory specified by $f. The argument is a hashref typically returned by File::RsyncP::FileList->get. Returns undef on success.

makeSpecial($f)

Create the special file specified by $f. The argument is a hashref typically returned by File::RsyncP::FileList->get. Returns undef on success.

unlink($remotePath)

Unlink the file or directory corresponding to the given remote path.

ignoreAttrOnFile($f)

Normally should return undef, meaning use the default setting of ignore-times. Otherwise, if this function returns zero or non-zero, the returned value overrides the setting of ignore-times for this file. The argument is a hashref typically returned by File::RsyncP::FileList->get. See the doPartial option in File::RsyncP->new().

File delta receiving functions¶

These functions are only called when we are receiving files. They are called by the child process.

fileDeltaRxStart($f, $cnt, $size, $remainder)

Start the receiving of file deltas for file $f, a hashref typically returned by File::RsyncP::FileList->get. The remaining arguments are the number of blocks, size of blocks, and size of the last (partial) block as generated by the parent on the receiving side (they are not the values the new file on the sending side). Returns undef on success.

fileDeltaRxNext($blk, $newData)

This function is called repeatedly as the file is constructed. Exactly one of $blk and $newData are defined. If $blk is defined it is an integer that specifies which block of the original file should be written at this point. If $newData is defined, it is literal data (that didn't match any blocks) that should be written at this point.

fileDeltaRxDone($md4)

Finish processing of the file deltas for this file. $md4 is the MD4 digest of the sent file. It should be compared against the MD4 digest of the reconstructed file. Returns undef on success, 1 if the file's MD4 didn't agree (meaning it should be repeated for phase 2), and negative on error.

File list sending function¶

fileListSend($fileList, $outputFunc)

Generate the file list (by calling $fileList->encode for every file to be sent) and call the output function $outputFunc with the output data by calling

    &$outputFunc($fileList->encodeData);