[WIP] Provided file system from NACL.

ppapi/c/dev/ppb_filesystemprovider_dev.h

+/* Copyright 2015 The Chromium Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+/* From dev/ppb_filesystemprovider_dev.idl modified Tue Jun 30 16:40:40 2015. */
+
+#ifndef PPAPI_C_DEV_PPB_FILESYSTEMPROVIDER_DEV_H_
+#define PPAPI_C_DEV_PPB_FILESYSTEMPROVIDER_DEV_H_
+
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_completion_callback.h"
+#include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/pp_var.h"
+
+#define PPB_FILESYSTEMPROVIDER_DEV_INTERFACE_0_1 \
+    "PPB_FilesystemProvider(Dev);0.1"
+#define PPB_FILESYSTEMPROVIDER_DEV_INTERFACE \
+    PPB_FILESYSTEMPROVIDER_DEV_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPB_FilesystemProvider</code> interface.
+ */
+
+
+/**
+ * @addtogroup Enums
+ * @{
+ */
+typedef enum {
+  PP_OperationType_NONE,
+  PP_OperationType_UNMOUNT,
+  PP_OperationType_GETMETADATA,
+  PP_OperationType_READDIRECTORY,
+  PP_OperationType_OPENFILE,
+  PP_OperationType_CLOSEFILE,
+  PP_OperationType_READFILE,
+  PP_OperationType_CREATEDIRECTORY,
+  PP_OperationType_DELETEENTRY,
+  PP_OperationType_CREATEFILE,
+  PP_OperationType_COPYENTRY,
+  PP_OperationType_MOVEENTRY,
+  PP_OperationType_TRUNCATEENTRY,
+  PP_OperationType_WRITEFILE,
+  PP_OperationType_ABORT,
+  PP_OperationType_ADDWATCHER,
+  PP_OperationType_REMOVEWATCHER
+} PP_OperationType_Dev;
+
+typedef enum {
+  PP_OpenFileMode_READ,
+  PP_OpenFileMode_WRITE,
+  PP_OpenFileMode_NONE
+} PP_OpenFileMode_Dev;
+
+typedef enum {
+  PP_ChangeType_CHANGED,
+  PP_ChangeType_DELETED
+} PP_ChangeType_Dev;
+/**
+ * @}
+ */
+
+/**
+ * @addtogroup Structs
+ * @{
+ */
+struct PP_FilesystemRequestUnmount {
+
+};
+
+struct PP_FilesystemRequestMetadata {
+  const char* entry_path;
+  PP_Bool thumbnail;
+};
+
+struct PP_FilesystemRequestReadDirectory {
+  const char* directory_path;
+};
+
+struct PP_FilesystemRequestOpenFile {
+  const char* file_path;
+  PP_OpenFileMode_Dev mode;
+};
+
+struct PP_FilesystemRequestCloseFile {
+  int32_t open_request_id;
+};
+
+struct PP_FilesystemRequestReadFile {
+  int32_t open_request_id;
+  uint64_t offset;
+  uint64_t length;
+};
+
+struct PP_FilesystemRequestCreateDirectory {
+  const char* directory_path;
+  PP_Bool recursive;
+};
+
+struct PP_FilesystemRequestDeleteEntry {
+  const char* entry_path;
+  PP_Bool recursive;
+};
+
+struct PP_FilesystemRequestCreateFile {
+  const char* file_path;
+};
+
+struct PP_FilesystemRequestCopyEntry {
+  const char* source_path;
+  const char* target_path;
+};
+
+struct PP_FilesystemRequestMoveEntry {
+  const char* source_path;
+  const char* target_path;
+};
+
+struct PP_FilesystemRequestTruncate {
+  const char* file_path;
+  int32_t length;
+};
+
+struct PP_FilesystemRequestWrite {
+  int32_t open_request_id;
+  uint64_t offset;
+  uint64_t data_size;
+  void* data;
+};
+
+struct PP_FilesystemRequestAbort {
+  int32_t operation_request_id;
+};
+
+struct PP_FilesystemRequestAddWatcher {
+  const char* entry_path;
+  PP_Bool recursive;
+};
+
+struct PP_FilesystemRequestRemoveWatcher {
+  const char* entry_path;
+  PP_Bool recursive;
+};
+
+/**
+ * The request format
+ */
+union PP_FilesystemRequestValue {
+  struct PP_FilesystemRequestUnmount as_unmount;
+  struct PP_FilesystemRequestMetadata as_metadata;
+  struct PP_FilesystemRequestReadDirectory as_read_directory;
+  struct PP_FilesystemRequestOpenFile as_open_file;
+  struct PP_FilesystemRequestCloseFile as_close_file;
+  struct PP_FilesystemRequestReadFile as_read_file;
+  struct PP_FilesystemRequestCreateDirectory as_create_directory;
+  struct PP_FilesystemRequestDeleteEntry as_delete_entry;
+  struct PP_FilesystemRequestCreateFile as_create_file;
+  struct PP_FilesystemRequestCopyEntry as_copy_entry;
+  struct PP_FilesystemRequestMoveEntry as_move_entry;
+  struct PP_FilesystemRequestTruncate as_truncate;
+  struct PP_FilesystemRequestWrite as_write_file;
+  struct PP_FilesystemRequestAbort as_abort;
+  struct PP_FilesystemRequestAddWatcher as_add_watcher;
+  struct PP_FilesystemRequestRemoveWatcher as_remove_watcher;
+};
+
+struct PP_FilesystemRequest {
+  PP_OperationType_Dev operation_type;
+  int32_t request_id;
+  union PP_FilesystemRequestValue value;
+};
+/**
+ * @}
+ */
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+/**
+ * File system provider interface.
+ * Typical usage:
+ * - Use Create() to create a new <code>PPB_FilesystemProvider_Dev resource
+ * - Call Mount() to register the new filesystem with the browser
+ *      This will create an entry in the file manager Chrome OS UI. The user
+ *      can select among the listed filesystem and issue file system operations
+ * - Call Unmount() to unregister the filesystem
+ *      This will remove the entry from the file manager Chrome OS UI.
+ * - Register callback for the <code>PP_FilesystemRequest</code> messages that
+ *   are sent from the browser with <code>GetNextRequest</code>
+ * - When a request is received and the processing results in a succcess:
+ *     - call <code>SendSuccessResponse</code> for requests DIFFERENT from
+ *           <code>PP_FilesystemRequestMetadata</code>,
+ *           <code>PP_FilesystemRequestReadDirectory</code>,
+ *           <code>PP_FilesystemRequestReadFile</code>
+ *     - call <code>SendMetadataSuccessResponse</code> for
+ *            <code>PP_FilesystemRequestMetadata</code> request
+ *     - call <code>SendReadFileSuccessResponse</code> for
+ *           <code>PP_FilesystemRequestReadFile</code> request
+ *     - call <code>SendReadDirectorySuccessResponse</code> for
+ *           <code>PP_FilesystemRequestReadDirectory</code> request
+ * - When a request is received and the processing results in an error:
+ *     - call <code>SendErrorResponse</code> for ALL requests
+ * - If a PP_FilesystemRequestWrite is received a subsequent call to
+ *   <code>FreeWriteRequestBuffer</code>
+ */
+struct PPB_FilesystemProvider_Dev_0_1 {
+  PP_Resource (*Create)(PP_Instance instance);
+  PP_Bool (*IsFilesystemProvider)(PP_Resource resource);
+  /**
+   * Mount() registers the file system
+   * @param[in] filesystem_id A <code>PP_VARTYPE_STRING</code>
+   * @param[in] display_name A <code> PP_VARTYPE_STRING</code>
+   * @param[in] writable A <code> PP_VARTYPE_BOOL </code>
+   * @param[in] opened_files_limit A <code>int32_t</code>
+   * @param[out] error A <code>int32_t</code>
+   * @param[in] callback A <code>PP_CompletionCallback</code> called when
+   * the operation completes asynchronously.
+   */
+  int32_t (*Mount)(PP_Resource filesystem_prov,
+                   struct PP_Var filesystem_id,
+                   struct PP_Var display_name,
+                   PP_Bool writable,
+                   int32_t opened_files_limit,
+                   struct PP_CompletionCallback callback);
+  /**
+   * Unmount() unregister the file system
+   * @param[in] filesystem_id A <code>PP_VARTYPE_STRING</code>
+   * @param[out] error A <code>int32_t</code>
+   * @param[in] callback <code>PP_CompletionCallback</code> called when the
+   * operation completes asynchronously.
+   */
+  int32_t (*Unmount)(PP_Resource filesystem_prov,
+                     struct PP_Var filesystem_id,
+                     struct PP_CompletionCallback callback);
+  /**
+   * Notify() notify of changes within the watched directories
+   * @param[in] notify_options A <code>PP_VARTYPE_DICTIONARY</code>
+   * @param[in] request_id A <code>int32_t</code> the id of the request
+   *     - "observedPath" : <code>PP_VARTYPE_STRING</code>
+   *     - "recursive" : <code>PP_VARTYPE_BOOL</code>
+   *     - "changeType" : <code> PP_ChangeType_Dev </code>
+   *     - "changes" : <code> PP_VARTYPE_ARRAY </code>
+   *            - <code> PP_VARTYPE_DICTIONARY </code>
+   *                - "entryPath": <code> PP_VARTYPE_STRING </code>
+   *                - "changeType": <code> PP_ChangeType_Dev </code>
+   *     - "tag" : <code> PP_VARTYPE_STRING </code>
+   */
+  int32_t (*Notify)(PP_Resource filesystem_prov, struct PP_Var notify_options);
+  /**
+   * Most of the operation will rely on the bellow 2 function calls to
+   * to report status to the browser.
+   * SendSuccessResponse() acknowledges the successful completion of the
+   * requested file system operation.
+   * @param[in] operation_type A <code>PP_OperationType_Dev</code>
+   * @param[in] request_id A <code>int32_t</code> the id of the request
+   */
+  int32_t (*SendSuccessResponse)(PP_Resource filesystem_prov,
+                                 PP_OperationType_Dev operation_type,
+                                 int32_t request_id);
+  /**
+   * SendErrorResponse() notifies the browser that the request failed.
+   * @param[in] operation_type A <code>PP_OperationType_Dev</code>
+   * @param[in] errpr A <code>int32_t</code>
+   * @param[in] request_id A <code>int32_t</code>
+   */
+  int32_t (*SendErrorResponse)(PP_Resource filesystem_prov,
+                               PP_OperationType_Dev operation_type,
+                               int32_t error,
+                               int32_t request_id);
+  /**
+   * Special functions that don't follow the above template
+   * for browser responses.
+   * SendMetadataSuccessResponse() acknowledges the successful retrieval of the
+   * metadata information
+   * @param[in] metadata A <code>PP_VARTYPE_DICTIONARY</code>
+   *     - "isDirectory" : <code>PP_VARTYPE_BOOL</code>
+   *     - "name" : <code>PP_VARTYPE_STRING(mandatory)</code>
+   *     - "size" : <code>PP_VARTYPE_DOUBLE</code>
+   *     - "modificationTime" : <code>PP_VARTYPE_STRING</code>
+   *     - "mimeType" :  <code>PP_VARTYPE_STRING</code>
+   *     - "thumbnail" : <code>PP_VARTYPE_STRING</code>
+   * @param[in] request_id <code>int32_t</code>
+   */
+  int32_t (*SendMetadataSuccessResponse)(PP_Resource filesystem_prov,
+                                         struct PP_Var metadata,
+                                         int32_t request_id);
+  /**
+   * SendReadDirectorySuccessResponse acknowledges the successful retrieval of
+   * metadatas information for directories and files
+   * @param[in] array_size A <code>uint32_t</code>
+   * @param[in] entries <code>PP_VARTYPE_ARRAY</code>
+   *            - an array of <code>PP_VARTYPE_DICTIONARY</code>
+   *                       - "isDirectory" : <code>PP_VARTYPE_BOOL</code>
+   *                       - "name" : <code>PP_VARTYPE_STRING(mandatory)</code>
+   *                       - "size" : <code>PP_VARTYPE_DOUBLE</code>
+   *                       - "modificationTime" : <code>PP_VARTYPE_STRING</code>
+   *                       - "mimeType" : <code>PP_VARTYPE_STRING</code>
+   *                       - "thumbnail" : <code>PP_VARTYPE_STRING</code>
+   * @param[in] has_more A <code>PP_VARTYPE_BOOL</code>
+   * @param[in] request_id A <code>int32_t</code>
+   */
+  int32_t (*SendReadDirectorySuccessResponse)(PP_Resource filesystem_prov,
+                                              struct PP_Var entries,
+                                              PP_Bool has_more,
+                                              int32_t request_id);
+  /**
+   * SendReadFileSuccessResponse() acknowledges the successful completion of a
+   * read request.
+   * @param[in] data_size A <code>uint32_t</code>
+   * @param[in] data A pointer to the begining of the file chunk read from file
+   * @param[in] has_more A <code>PP_VARTYPE_BOOL</code>
+   * @param[in] request_id A <code>int32_t</code>
+   */
+  int32_t (*SendReadFileSuccessResponse)(PP_Resource filesystem_prov,
+                                         uint32_t data_size,
+                                         const void* data,
+                                         PP_Bool has_more,
+                                         int32_t request_id);
+  /**
+   * GetNextRequest() registers a callback for any pending requests.
+   * @param[out] request A <code>PP_FilesystemRequest</code> this contains the
+   * request for a file system operation
+   * @param[in] callback A <code>PP_CompletionCallback</code> that is called
+    when
+   * a request becomes available.
+   */
+  int32_t (*GetNextRequest)(PP_Resource filesystem_prov,
+                            struct PP_FilesystemRequest* request,
+                            struct PP_CompletionCallback callback);
+  /**
+   * FreeWriteRequestBuffer frees resource buffer. This MUST be called after the
+   * request is processed
+   * @param[in] buffer A pointer to the start of the file chunk in memory
+   */
+  int32_t (*ReleaseRequestBuffer)(PP_Resource filesystem_prov,
+                                  int32_t request_id);
+};
+
+typedef struct PPB_FilesystemProvider_Dev_0_1 PPB_FilesystemProvider_Dev;
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_DEV_PPB_FILESYSTEMPROVIDER_DEV_H_ */
+