Documentation for the REST ls call should enumerate what "Type" integers are or point to more information.

[Erotemic]

I was playing with ipfsfsspec and noticed that they failed to ls one of my directories. The error was because they didn't handle ls return entries with "Type 4". I had no idea what Type 4 was.

I find the API docs for ls here: http://docs.ipfs.tech.ipns.localhost:8080/reference/kubo/rpc/#api-v0-ls

And it tells me that Type is an int32 return value, but makes no mention of what the return values mean, nor does it point to information where I can find out.

I did find some info here: https://ipfs-search.readthedocs.io/en/latest/ipfs_datatypes.html

and here: https://github.com/ipfs/go-unixfs/blob/master/pb/unixfs.proto

and was able to infer type 4 was symlink, but the docs should be updated to make this easier for the next person who wants to figure out how ls works via the REST API.

Tasks

Beta Give feedback

No tasks being tracked yet.

[lidel]

Thank you for reporting.
This seems to be a duplicate of #1260, let's continue there.