Investigate grabbing multiple resources like "ils -L"

[jjacquay712]

Data objects can be contained within multiple resources, figure out how to get that information. Currently we save a single "resource" string when reading a collection, maybe it's comma delimited?

[jjacquay712]

Did a quick check on a replicated resource and it seems to only show a single resource for a given data object. If a resource is replicated then ‘ils -L’ will show the data object twice and the second entry has the other storage resource. If I view the same collection in GoRods its only showing the first data object, not the replicated one. If I delete the original data object then it will show the replica in the other storage resource.

[jjacquay712]

@simont It appears that the code in "ils" calls different functions to read the collections depending on the parameters that are passed. GoRods exclusively uses rcReadCollection, whereas ils uses that, as well as a combination of generic database queries:

https://github.com/irods/irods/blob/a1db0f5defa9a34f72be3be1e4f8ae24965f9187/iRODS/lib/core/src/lsUtil.cpp#L129 https://github.com/irods/irods/blob/a1db0f5defa9a34f72be3be1e4f8ae24965f9187/iRODS/lib/core/src/lsUtil.cpp#L369

Need to refactor C.gorods_read_collection to query database rather than call higher level rcReadCollection() function.

[jacquayj]

It turns out all I needed was a NO_TRIM_REPL_FG flag set when opening the collection. The rcGenQuery calls in ils are used to get additional info about a particular data obj or bundle, so I don't have to implement that for this issue. rcReadCollection will work fine.

The next step is implementing a parameter in GoRods to set this flag if functionality is needed. Will refactor Connection.Collection to accept option struct that contains TrimRepls bool field (along with path, recursive, etc...).

[jacquayj]

Example for using new Connection.Collection function:

myCollection, colErr := irods.Collection(gorods.CollectionOptions{
    Path:       "/tempZone/home/rods/source-code",
    Recursive:  true,
    TrimRepls:  false, // When this is set to false (by default) it will return all replicas of a data object
})