cStor云存储系统API开发手册初稿_20130109【云创大数据】.docxVIP

旗开得胜 旗开得胜 PAGE PAGE # J七 7读万卷书行万里路 旗开得胜 旗开得胜 PAGE PAGE # J七 7读万卷书行万里路 引言 1.2. 获取方法 系统高速 3.1. 3.2. 3.3. 3.3.1 3.3.2 3.4. 3.4.1 3.4.2 3.4.3 3.4.4 3.. 编写目的 更新时间 API 总体设计 使用方法 数据结构 错误类型定义 文件打开类型定义 函数说明 cstor_clie nt_init cstor_clie nt_destroy cstor_create_file cstor_create_directory ?3. ?3. 3.. .4. 5. 5. 6. 6. 6. 8. 旗开得胜 旗开得胜 PAGE # PAGE # 7读万卷书行万里路 旗开得胜 旗开得胜 PAGE # PAGE # 一 e j读万卷书行万里路 旗开得胜 旗开得胜 PAGE PAGE # 345 cstor_ open _file 9. 346 cstor_close_file .1.0 3.4.7 cstor_write_by_file name 11 3.4.8 cstor_write_by_filebuff 12 3.4.9 cstor_read_by_file name 1.3 3.4.10 cstor_read_by_filebuff 14 3.5. 附加说明 16 =a 7读万卷书行万里路 引言 1.1.编写目的 cStor通过API的方式开放一些应用接口，这篇文档用来介绍 cStor 目前开放的系统高速API ,为应用程序的开发人员提供技术和文档服务。 1.2.更新时间 最后修订日期：2013-01-09 版本号：v1.0 、 获取方法 系统高速API 3.1.总体设计 cStor系统高速API可实现对客户端的初始化及注销，文件的创建、 打开、关闭，以及文件以文件名直接读写和从文件缓冲区以一定的偏移量 并行读写功能，以提高系统性能。 32 使用方法 本API的使用说明如下: 1）添加库文件环境变量; 在Linux环境下: echo ex port LD_LIBRARY_ PATH=/o pt/cstor/lib:$LD_LIBRARY_ PATH -/.bashrc 在Windows环境下: 2) 编写应用程序，编译即可。 33 数据结构 3.3.1 错误类型定义 #defi ne CSTOR SUCCESS 0 /*操作成功/ #defi ne CSTOR ERROR -1 /* Gen eral Error / #defi ne CSTOR ERROR FILE EXISTS -2 /*文件已存在/ #defi ne CSTOR ERROR FILE NOT EXISTS -3/* 文件不存在/ #defi ne CSTOR NAME TOO LONG -4/* 名字太长/ #defi ne CSTOR FILE TOO LONG -5/* 文件太长/ #defi ne CSTOR UNREG FILE -6/*文件未注册/ #defi ne CSTOR FILE INFO ERROR -7/*文件信息错误/ #defi ne CSTOR INPUT INFO ERROR -8 /*输入信息错误/ 旗开得胜 旗开得胜 PAGE # PAGE # 读万卷书行万里路 旗开得胜 旗开得胜 PAGE PAGE # #define CSTOR NOT FILE -9/*非文件/ 3.3.2 文件打开类型定义 enum {IO_NONE,IO_READ,IO_WRITE,IO_READONL Y,IO_WRITEONL Y}; 34 函数说明 3.4.1 cstor client init 函数功能：根据配置文件参数初始化客户端 函数原型:int cstor_client_init( const char * conf_filename); 参数说明: conf file name: 配置文件名 返回值:return: 0 success, !=0 fail, return the error code （操作成功则返回0，失败时为非0值，返回具体错误类型） =a 7读万卷书行万里路 示例代码: cstor_client_destroy 函数功能：客户端注销 函数原型:void cstor_client_destroy(); 返回值：此函数不需要返回值 示例代码: cstor create file 函数功能：创建一个文件 函数原型：int cstor_create_file( const char* file name, int