gateway: add GetHome (cs3org#39)

Author: labkode

cs3/gateway/v0alpha/gateway.proto

@@ -31,6 +31,7 @@ option php_namespace = "CS3\\GatewayV0Alpha";
 import "cs3/auth/v0alpha/auth.proto";
 import "cs3/storageprovider/v0alpha/resources.proto";
 import "cs3/storageprovider/v0alpha/storageprovider.proto";
+import "cs3/storageregistry/v0alpha/storageregistry.proto";
 import "cs3/types/types.proto";
 import "cs3/usershareprovider/v0alpha/usershareprovider.proto";
 
@@ -155,6 +156,12 @@ service GatewayService {
   // Get the information for the given received share reference.
   // MUST return CODE_NOT_FOUND if the received share reference does not exist.
   rpc GetReceivedShare(cs3.usershareproviderv0alpha.GetReceivedShareRequest) returns (cs3.usershareproviderv0alpha.GetReceivedShareResponse);
+  // *****************************************************************/
+  // ************************ STORAGE REGISTRY ** ********************/
+  // *****************************************************************/
+  // Returns the home path for the given authenticated user.
+  // When a user has access to multiple storage providers, one of them is the home.
+  rpc GetHome(cs3.storageregistryv0alpha.GetHomeRequest) returns (cs3.storageregistryv0alpha.GetHomeResponse);
 }
 
 message GetQuotaRequest {

docs/index.html

@@ -2782,6 +2782,16 @@ <h3 id="cs3.gatewayv0alpha.GatewayService">GatewayService</h3>
 MUST return CODE_NOT_FOUND if the received share reference does not exist.</p></td>
               </tr>
 
+              <tr>
+                <td>GetHome</td>
+                <td><a href="#cs3.storageregistryv0alpha.GetHomeRequest">.cs3.storageregistryv0alpha.GetHomeRequest</a></td>
+                <td><a href="#cs3.storageregistryv0alpha.GetHomeResponse">.cs3.storageregistryv0alpha.GetHomeResponse</a></td>
+                <td><p>STORAGE REGISTRY ** ********************/
+*****************************************************************/
+Returns the home path for the given authenticated user.
+When a user has access to multiple storage providers, one of them is the home.</p></td>
+              </tr>
+            
           </tbody>
         </table>