src/usr.bin/ssh/PROTOCOL - diff

Return to PROTOCOL CVS log

Up to [local] / src / usr.bin / ssh

Diff for /src/usr.bin/ssh/PROTOCOL between version 1.46 and 1.47

-version 1.46, 2022/08/12 05:20:28
+version 1.47, 2022/09/19 10:40:52
 Line 635
 Line 635
 Line 635
  https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-extensions-00#section-5
+.12. sftp: Extension request "users-groups-by-id@openssh.com"
+ This request asks the server to returns user and/or group names that
+ correspond to one or more IDs (e.g. as returned from a SSH_FXP_STAT
+ request). This may be used by the client to provide usernames in
+ directory listings.
+         byte            SSH_FXP_EXTENDED
+         uint32          id
+         string          "users-groups-by-id@openssh.com"
+         string          uids
+         string          gids
+ Where "uids" and "gids" consists of one or more integer user or group
+ identifiers:
+         uint32          id-0
+         ...
+ The server will reply with a SSH_FXP_EXTENDED_REPLY:
+         byte            SSH_FXP_EXTENDED_REPLY
+         string          usernames
+         string          groupnames
+ Where "username" and "groupnames" consists of names in identical request
+ order to "uids" and "gids" respectively:
+         string          name-0
+         ...
+ If a name cannot be identified for a given user or group ID, an empty
+ string will be returned in its place.
+ It is acceptable for either "uids" or "gids" to be an empty set, in
+ which case the respective "usernames" or "groupnames" list will also
+ be empty.
+ This extension is advertised in the SSH_FXP_VERSION hello with version
+ "1".
 . Miscellaneous changes
 .1 Public key format