HDDS-13409. Add supported operations for Ofs. #8763
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Unlike httpsfs user doc https://ozone.apache.org/docs/edge/interface/httpfs.html we don't list the supported operation for Ofs. This patch adds a table in the 'Ofs (Hadoop compatible)' page for supported operations. The table has columns 'Operation', 'Description', 'Support' where 'Operation' is the exact operation name in the audit log, 'Description' is a few words of short description, and 'Support' is either Supported or Unsupported. Add footnotes for any caveats. Change-Id: I6613f5f13f23394c30da83ce41e22b28f6d04732
Adds a table for HDFS-specific operations that are not part of the general Hadoop FileSystem API and are therefore not supported by Ofs. Change-Id: Ibfc51daf614aa5cf0d56e1037b64856c4980c4e5
The "Supported Operations" table in the OFS documentation was missing several methods that are part of the public FileSystem API and are implemented in `RootedOzoneFileSystem`. This commit updates the table to include these methods, providing a more complete and accurate reference for developers. Change-Id: Iace6c9dd21bf6cae3701b0d5a620882c1976899e
ayushtkn
reviewed
Jul 9, 2025
Comment on lines
326
to
337
| | `setXAttr` | Sets an extended attribute. | Unsupported | | ||
| | `getXAttr` | Gets an extended attribute. | Unsupported | | ||
| | `listXAttrs` | Lists extended attributes. | Unsupported | | ||
| | `removeXAttr` | Removes an extended attribute. | Unsupported | | ||
| | `setAcl` | Sets an ACL. | Unsupported | | ||
| | `getAclStatus` | Gets an ACL status. | Unsupported | | ||
| | `modifyAclEntries` | Modifies ACL entries. | Unsupported | | ||
| | `removeAclEntries` | Removes ACL entries. | Unsupported | | ||
| | `removeDefaultAcl` | Removes the default ACL. | Unsupported | | ||
| | `removeAcl` | Removes an ACL. | Unsupported | | ||
| | `truncate` | Truncates a file. | Unsupported | | ||
| | `concat` | Concatenates files. | Unsupported | |
Member
There was a problem hiding this comment.
the above heading says
## Supported Operations
The following table lists the supported operations for Ofs.
But we mention unsupported methods as well in this table
Change-Id: I41bdbc9b347a474bb3abb6e80b73b5914f02ad87
Contributor
Author
|
@ayushtkn let me know how you think about this revision. thx |
ayushtkn
approved these changes
Jul 10, 2025
| <value>org.apache.hadoop.fs.ozone.OzoneTrashPolicy</value> | ||
| </property> | ||
| {{< /highlight >}} | ||
| {{< highlight >}} |
Member
There was a problem hiding this comment.
this seems accidental, it gives error
Error: error building site: assemble: "/Users/ayushsaxena/code/ozone/hadoop-hdds/docs/content/interface/Ofs.md:233:1": failed to extract shortcode: shortcode "highlight" must be closed or self-closed
Contributor
Author
There was a problem hiding this comment.
thanks for catching it! fixed.
Change-Id: Ic095bbbc604d90a79235d321365f6ca4bd94af32
Contributor
Author
|
Merged. Thanks @ayushtkn |
jojochuang
added a commit
to jojochuang/ozone
that referenced
this pull request
Jul 31, 2025
Generated-by: Google Gemini 2.5 Pro, Gemini Cli
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What changes were proposed in this pull request?
Provide a one-liner summary of the changes in the PR Title field above.
It should be in the form of
HDDS-1234. Short summary of the change.Please describe your PR in detail:
Unlike httpsfs user doc https://ozone.apache.org/docs/edge/interface/httpfs.html we don't list the supported operation for Ofs.
This patch adds a table in the 'Ofs (Hadoop compatible)' page for supported operations.
The table has columns 'Operation', 'Description', 'Support' where 'Operation' is the exact operation name in the audit log, 'Description' is a few words of short description, and 'Support' is either Supported or Unsupported. Add footnotes for any caveats.
Adds a table for HDFS-specific operations that are not part of the general Hadoop FileSystem API and are therefore not supported by Ofs.
Generated-by: Google Gemini 2.5 Pro + Gemini Cli.
What is the link to the Apache JIRA
https://issues.apache.org/jira/browse/HDDS-13409
How was this patch tested?
Documentation only change.