中文Linux应用编程界面(API)规范

1、中国电子技术标准化研究所认证技术规范CESI002-200X中文Linux应用编程界面(API)规范Specification for Chinese Linux application programming interface(申请备案稿)XXXX-XX-XX发布XXXX -XX-XX实施中国电子技术标准化研究所 发布目 次前言II1范围12规范性引用文件13术语和定义14Linux标准基础规范24.1基本库24.2实用工具库164.3命令和实用工具184.4执行环境194.5系统初始化234.6用户和组295输入法接口305.1体系结构305.2通用输入法编程界面规范30附录A（规范性附

2、录）输入法协议中的键盘编码定义54A.1键盘修饰键掩码定义54A.2键盘编码定义54前 言本规范在完全遵循ISO/IEC 23360-1的API要求基础上，加入了输入法接口，以解决Linux操作系统下应用程序的兼容性及可移植性问题。本标准由中华人民共和国信息产业部提出。本标准由全国信息技术标准化技术委员会归口。本标准主要起草单位：中软网络技术股份有限公司、信息产业部电子工业标准化研究所、中国科学院软件研究所、北京中科红旗软件技术有限公司、新华科技(南京)系统有限公司、北京络威尔软件有限公司、太阳计算机系统（中国）有限公司、北京即时俊业软件有限公司、红帽软件（北京）有限公司、信息产业部软件与集成

3、电路促进中心、北京共创开源软件有限公司。本标准主要起草人：周明德、高林、张东、谢谦、李祥凯、苏哲、王自强、郑忠源、郭峰、苏建中、向剑岭、张海峰、董清富、黄建中、刘俊贤、霍东灵、邵宇、朱兴雄、杨少鹏。 中文Linux应用编程界面(API)规范1 范围本规范规定了中文LINUX操作系统为应用程序提供的必要接口和运行环境，包括基本库、实用程序库、命令和实用程序、执行环境、以及国际化和本地化函数等,以支持应用程序源码级的可移植性。本规范适用于Linux应用程序开发者和Linux系统实现者。2 规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单（不

4、包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范。ISO/IEC 9945-2:2003 Information technology Portable Operating System Interface(POSIX) Part 2:System InterfacesISO/IEC 23360-1 Linux Standard Base (LSB) core specification 3.1 - Part 1: Generic specificationISO/IEC 9899:19

5、99 Information technology - Programming Language C3 术语和定义下列术语和定义适合本规范。3.1Shell脚本 shell script由解释程序（例如，awk）读的文件。Shell脚本的第一行包括对它的二进制解释程序的引用。3.2字符 character一个或多个字节序列，代表单个图形符号或控制码。此术语相应于ISO C标准术语multibyte character (多字节字符)，其中，单字节字符是多字节字符的特殊情况。不像在ISO C标准中的使用，此处字符（ character）不必与存储空间相关，当讨论存储空间时用字节。3.3字节 by

6、te数据存储的一个独立能寻址的单元，它等于或大于一个八位位组，用于存储一字符或字符的一部分，见character。一个字节是由连续的位序列组成，它的位数是实现相关的。最小有效位称为低序位，最高有效位称为高序位。注意，字节的这种定义是故意脱离在某些国际标准中字节的使用，在那儿字节用作八位位组（始终为八位）的同义字。在基于ISO/IEC 9945-2:1993标准的系统中，一个字节可以大于八位，所以，它可以是大的数据对象的完整的一部分，甚至于不能被八位除（例如一36-位字，它包含四个9-位字节）。3.4字符集 character set不同字符的一有限集，用于表示、组织或控制数据。3.5编码字符集

7、 coded character set一有明确规则的集，它建立字符集和在集中的每个字符与它的位表示有一对一的关系。3.6语境 locale用户环境的子集定义，它依赖于语言和文化约定。3.7本地习惯 local customs地理区域或版图对于某些事项例如日期、时间和货币格式的约定。3.8本地化 localization计算机系统中建立专用于具体的国家语言、当地习惯和编码字符集操作信息的过程。3.9输入方法引擎 input method engine输入方法构造块的部件或模块，它从一个或多个事件或串序列构造串，实现语言或脚本特定的逻辑。它能独立于窗口系统、图形用户界面或可视化外观。4 Linu

8、x标准基础规范4.1 基本库4.1.1 libc 接口在libc中提供了以下函数接口和数据接口：4.1.1.1 RPC表1 RPC函数接口authnone_createclnt_createclnt_pcreateerrorclnt_perrnoclnt_perrorclnt_spcreateerrorclnt_sperrnoclnt_sperrorkey_decryptsessionpmap_getportpmap_setpmap_unsetsvc_getreqsetsvc_registersvc_runsvc_sendreplysvcerr_authsvcerr_decodesvcerr_

9、noprocsvcerr_noprogsvcerr_progverssvcerr_systemerrsvcerr_weakauthsvctcp_createsvcudp_createxdr_accepted_replyxdr_arrayxdr_boolxdr_bytesxdr_callhdrxdr_callmsgxdr_charxdr_doublexdr_enumxdr_floatxdr_freexdr_intxdr_longxdr_opaquexdr_opaque_authxdr_pointerxdr_referencexdr_rejected_replyxdr_replymsgxdr_sh

10、ortxdr_stringxdr_u_charxdr_u_intxdr_u_longxdr_u_shortxdr_unionxdr_vectorxdr_voidxdr_wrapstringxdrmem_createxdrrec_createxdrrec_eof4.1.1.2 系统调用表2 系统调用函数接口_fxstat_getpgid_lxstat_xmknod_xstataccessacctalarmbrkchdirchmodchownchrootclockcloseclosedircreatdupdup2execlexecleexeclpexecvexecveexecvpexitfchdi

11、rfchmodfchownfcntlfdatasyncflockforkfstatvfsfsyncftimeftruncategetcontextgetegidgeteuidgetgidgetgroupsgetitimergetloadavggetpagesizegetpgidgetpgrpgetpidgetppidgetprioritygetrlimitgetrusagegetsidgetuidgetwdinitgroupsioctlkillkillpglchownlinklockflseekmkdirmkfifomlockmlockallmmapmprotectmsyncmunlockmu

12、nlockallmunmapnanosleepniceopenopendirpathconfpausepipepollreadreaddirreaddir_rreadlinkreadvrenamermdirsbrksched_get_priority_maxsched_get_priority_minsched_getparamsched_getschedulersched_rr_get_intervalsched_setparamsched_setschedulersched_yieldselectsetcontextsetegidseteuidsetgidsetitimersetpgids

13、etpgrpsetprioritysetregidsetreuidsetrlimitsetrlimit64setsidsetuidsleepstatvfsstimesymlinksyncsysconftimetimestruncateulimitumaskunameunlinkutimeutimesvforkwaitwait4waitpidwritewritev4.1.1.3 标准 I/O表3 标准I/O函数接口_IO_feof_IO_getc_IO_putc_IO_putsasprintfclearerrctermidfclosefdopenfeofferrorfflushfflush_un

14、lockedfgetcfgetposfgetsfgetwc_unlockedfilenoflockfilefopenfprintffputcfputsfreadfreopenfscanffseekfseekofsetposftellftellofwritegetcgetc_unlockedgetchargetchar_unlockedgetwpclosepopenprintfputcputc_unlockedputcharputchar_unlockedputsputwremoverewindrewinddirscanfseekdirsetbufsetbuffersetvbufsnprintf

15、sprintfsscanftelldirtempnamungetcvasprintfvdprintfvfprintfvprintfvsnprintfvsprintf表4 标准I/O数据接口stderrstdinstdout4.1.1.4 信号处理表5 信号处理函数接口_libc_current_sigrtmax_libc_current_sigrtmin_sigsetjmp_sysv_signalbsd_signalpsignalraisesigactionsigaddsetsigaltstacksigandsetsigdelsetsigemptysetsigfillsetsigholdsig

16、ignoresiginterruptsigisemptysetsigismembersiglongjmpsignalsigorsetsigpausesigpendingsigprocmasksigqueuesigrelsesigreturnsigsetsigsuspendsigtimedwaitsigwaitsigwaitinfo表6 信号处理数据接口_sys_siglist4.1.1.5 本地化函数表7 本地化函数函数接口bind_textdomain_codesetbindtextdomaincatclosecatgetscatopendcgettextdcngettextdgettext

17、dngettextduplocale(GLIBC_2.3)freelocale(GLIBC_2.3)gettexticonviconv_closeiconv_openlocaleconvnewlocale(GLIBC_2.3)ngettextnl_langinfosetlocaletextdomainuselocale(GLIBC_2.3)表8 本地化函数数据接口_nl_msg_cat_cntr4.1.1.6 套接字接口表9 套接字函数接口_h_errno_locationacceptbindbindresvportconnectgethostidgethostnamegetpeernameg

18、etsocknamegetsockoptif_freenameindexif_indextonameif_nameindexif_nametoindexlistenrecvrecvfromrecvmsgsendsendmsgsendtosetsockoptshutdownsockatmarksocketsocketpair4.1.1.7 宽字符表10 宽字符函数接口_wcstod_internal_wcstof_internal_wcstol_internal_wcstold_internal_wcstoul_internalbtowcfgetwcfgetwsfputwcfputwsfwide

19、fwprintffwscanfgetwcgetwcharmblenmbrlenmbrtowcmbsinitmbsnrtowcsmbsrtowcsmbstowcsmbtowcputwcputwcharswprintfswscanftowctranstowlowertowupperungetwcvfwprintfvfwscanfvswprintfvswscanfvwprintfvwscanfwcpcpywcpncpywcrtombwcscasecmpwcscatwcschrwcscmpwcscollwcscpywcscspnwcsdupwcsftimewcslenwcsncasecmpwcsnca

20、twcsncmpwcsncpywcsnlenwcsnrtombswcspbrkwcsrchrwcsrtombswcsspnwcsstrwcstodwcstofwcstoimaxwcstokwcstolwcstoldwcstollwcstombswcstoqwcstoulwcstoullwcstoumaxwcstouqwcswcswcswidthwcsxfrmwctobwctombwctranswctypewcwidthwmemchrwmemcmpwmemcpywmemmovewmemsetwprintfwscanf4.1.1.8 字符串函数表11 字符串函数函数接口_mempcpy_rawme

21、mchr_stpcpy_strdup_strtod_internal_strtof_internal_strtok_r_strtol_internal_strtold_internal_strtoll_internal_strtoul_internal_strtoull_internalbcmpbcopybzeroffsindexmemccpymemchrmemcmpmemcpymemmovememrchrmemsetrindexstpcpystpncpystrcasecmpstrcasestrstrcatstrchrstrcmpstrcollstrcpystrcspnstrdupstrerr

22、orstrerror_rstrfmonstrftimestrlenstrncasecmpstrncatstrncmpstrncpystrndupstrnlenstrpbrkstrptimestrrchrstrsepstrsignalstrspnstrstrstrtofstrtoimaxstrtokstrtok_rstrtoldstrtollstrtoqstrtoullstrtoumaxstrtouqstrxfrmswab4.1.1.9 IPC 函数表12 IPC函数函数接口ftokmsgctlmsggetmsgrcvmsgsndsemctlsemgetsemopshmatshmctlshmdt

23、shmget4.1.1.10 正则表达式表13 正则表达式函数接口regcompregerrorregexecregfree4.1.1.11 字符类型函数表13 字符类型函数函数接口_ctype_b_loc(GLIBC_2.3)_ctype_get_mb_cur_max_ctype_tolower_loc(GLIBC_2.3)_ctype_toupper_loc(GLIBC_2.3)_tolower_toupperisalnumisalphaisasciiiscntrlisdigitisgraphislowerisprintispunctisspaceisupperiswalnumiswalp

24、haiswblankiswcntrliswctypeiswdigitiswgraphiswloweriswprintiswpunctiswspaceiswupperiswxdigitisxdigittoasciitolowertoupper4.1.1.12 时间操作表14 时间操作函数接口adjtimeasctimeasctime_rctimectime_rdifftimegmtimegmtime_rlocaltimelocaltime_rmktimetzsetualarm表15 时间操作数据接口_daylight_timezone_tznamedaylighttimezonetzname4.

25、1.1.13 终端接口函数表16 终端接口函数函数接口cfgetispeedcfgetospeedcfmakerawcfsetispeedcfsetospeedcfsetspeedtcdraintcflowtcflushtcgetattrtcgetpgrptcgetsidtcsendbreaktcsetattrtcsetpgrp4.1.1.14 系统数据库表17 系统数据库函数接口endgrentendprotoentendpwentendserventendutentendutxentgetgrentgetgrgidgetgrgid_rgetgrnamgetgrnam_rgetgroupli

26、stgethostbyaddrgethostbynamegetprotobynamegetprotobynumbergetprotoentgetpwentgetpwnamgetpwnam_rgetpwuidgetpwuid_rgetservbynamegetservbyportgetserventgetutentgetutent_rgetutxentgetutxidgetutxlinepututxlinesetgrentsetgroupssetprotoentsetpwentsetserventsetutentsetutxentutmpname4.1.1.15 语言支持表18 语言支持函数接口

27、_libc_start_main_register_atfork(GLIBC_2.3.2)4.1.1.16 大文件支持表19 大文件支持函数接口_fxstat64_lxstat64_xstat64creat64fgetpos64fopen64freopen64fseeko64fsetpos64fstatvfs64ftello64ftruncate64ftw64getrlimit64lockf64mkstemp64mmap64nftw64readdir64statvfs64tmpfile64truncate644.1.1.17 标准库表20 标准库函数接口_Exit_assert_fail_cx

28、a_atexit_errno_location_fpending_getpagesize_isinf_isinff_isinfl_isnan_isnanf_isnanl_sysconf_exit_longjmp_setjmpa64labortabsatofatoiatolatollbasenamebsearchcalloccloselogconfstrcuseriddaemondirnamedivdrand48ecvterand48errerrorerrxfcvtfmtmsgfnmatchfpathconffreefreeaddrinfoftrylockfileftwfunlockfilega

29、i_strerrorgcvtgetaddrinfogetcwdgetdategetenvgetlogingetlogin_rgetnameinfogetoptgetopt_longgetopt_long_onlygetsuboptgettimeofdayglobglob64globfreeglobfree64grantpthcreatehdestroyhsearchhtonlhtonsimaxabsimaxdivinet_addrinet_ntoainet_ntopinet_ptoninitstateinsqueisattyisblankjrand48l64alabslcong48ldivlf

30、indllabslldivlongjmplrand48lsearchmakecontextmallocmemmemmkstempmktempmrand48nftwnrand48ntohlntohsopenlogperrorposix_memalignposix_openptptsnameputenvqsortrandrand_rrandomreallocrealpathremqueseed48setenvsethostnamesetlogmasksetstatesrandsrand48srandomstrtodstrtolstrtoulswapcontextsyslogsystemtdelet

31、etfindtmpfiletmpnamtsearchttynamettyname_rtwalkunlockptunsetenvusleepverrxvfscanfvscanfvsscanfvsyslogwarnwarnxwordexpwordfree表21 标准库数据接口_environ_environ_sys_errlistenvirongetdate_erroptargopterroptindoptopt4.1.2 libc的数据定义该部分定义与libc中接口相关联的全局标识符及其取值，这些定义按照相应的系统头文件分组组织。这些约定仅用于为读者提供方便，并不意味着这些头文件或内容必须按本规

32、范列出的形式存在。本规范采用ISO C（1999） 作为参考的编程语言，数据定义按照ISO C (1999)格式进行规定。在此处使用C语言仅仅是为了方便，这些用C 语言描述的数据对象并不排除被其他编程语言所使用。这些数据定义所在的头文件包括：arpa/inet.hassert.hctype.hdirent.herr.herrno.hfcntl.hfmtmsg.hfnmatch.hftw.hgetopt.hglob.hgrp.hiconv.hinttypes.hlanginfo.hlibgen.hlibintl.hlimits.hlocale.hmonetary.hnet/if.hnetdb.h

33、netinet/in.hnetinet/ip.hnetinet/tcp.hnetinet/udp.hnl_types.hpoll.hpty.hpwd.hregex.hrpc/auth.hrpc/clnt.hrpc/pmap_clnt.hrpc/rpc_msg.hrpc/svc.hrpc/types.hrpc/xdr.hsched.hsearch.hsetjmp.hsignal.hstddef.hstdio.hstdlib.hstring.hsys/file.hsys/ioctl.hsys/ipc.hsys/mman.hsys/msg.hsys/param.hsys/poll.hsys/reso

34、urce.hsys/sem.hsys/shm.hsys/socket.hsys/stat.hsys/statvfs.hsys/time.hsys/timeb.hsys/times.hsys/types.hsys/uio.hsys/un.hsys/utsname.hsys/wait.hsyslog.htermios.htime.hucontext.hulimit.hunistd.hutime.hutmp.hutmpx.hwchar.hwctype.hwordexp.h这些数据定义的头文件的详细内容见ISO/IEC 23360-1的基本库部分。4.1.3 libc的接口定义本标准没有对libc的接

35、口进行扩充，4.1.1中表述的所有函数的详细描述见ISO/IEC 23360-1的基本库部分。4.1.4 libm接口libm库中规定了数学计算的接口。表22 数学计算函数接口_finite_finitef_finitel_fpclassify_fpclassifyf_signbit_signbitfacosacosfacoshacoshfacoshlacoslasinasinfasinhasinhfasinhlasinlatanatan2atan2fatan2latanfatanhatanhfatanhlatanlcabscabsfcabslcacoscacosfcacoshcacoshfc

36、acoshlcacoslcargcargfcarglcasincasinfcasinhcasinhfcasinhlcasinlcatancatanfcatanhcatanhfcatanhlcatanlcbrtcbrtfcbrtlccosccosfccoshccoshfccoshlccoslceilceilfceillcexpcexpfcexplcimagcimagfcimaglclogclog10clog10fclog10lclogfcloglconjconjfconjlcopysigncopysignfcopysignlcoscosfcoshcoshfcoshlcoslcpowcpowfcp

37、owlcprojcprojfcprojlcrealcrealfcreallcsincsinfcsinhcsinhfcsinhlcsinlcsqrtcsqrtfcsqrtlctanctanfctanhctanhfctanhlctanldremfdremlerferfcerfcferfclerfferflexpexp2exp2fexpfexplexpm1expm1fexpm1lfabsfabsffabslfdimfdimffdimlfeclearexceptfegetenvfegetexceptflagfegetroundfeholdexceptferaiseexceptfesetenvfeset

38、exceptflagfesetroundfetestexceptfeupdateenvfinitefiniteffinitelfloorfloorffloorlfmafmaffmalfmaxfmaxffmaxlfminfminffminlfmodfmodffmodlfrexpfrexpffrexplgammagammafgammalhypothypotfhypotlilogbilogbfilogblj0j0fj0lj1j1fj1ljnjnfjnlldexpldexpfldexpllgammalgamma_rlgammaflgammaf_rlgammallgammal_rllrintllrint

39、fllrintlllroundllroundfllroundlloglog10log10flog10llog1plog1pflog1pllog2log2flog2llogblogbflogbllogflogllrintlrintflrintllroundlroundflroundlmatherrmodfmodffmodflnannanfnanlnearbyintnearbyintfnearbyintlnextafternextafterfnextafterlnexttowardnexttowardfnexttowardlpowpow10pow10fpow10lpowfpowlremainder

40、remainderfremainderlremquoremquofremquolrintrintfrintlroundroundfroundlscalbscalbfscalblscalblnscalblnfscalblnlscalbnscalbnfscalbnlsignificandsignificandfsignificandlsinsincossincosfsincoslsinfsinhsinhfsinhlsinlsqrtsqrtfsqrtltantanftanhtanhftanhltanltgammatgammaftgammaltrunctruncftruncly0y0fy0ly1y1f

41、y1lynynfynl表23 数学计算数据接口signgam4.1.5 Libm的数据定义它规定了以下头文件：complex.hfenv.hmath.h此头文件的具体内容见ISO/IEC 23360-1的基本库部分。4.1.6 libm的接口定义本标准没有对libm的接口进行扩充，4.1.4中表述的所有函数的详细描述见ISO/IEC 23360-1的基本库部分。4.1.7 libpthread接口libpthread规定了以下的接口：4.1.7.1 实时线程表24 实时线程函数接口pthread_attr_getinheritschedpthread_attr_getschedpolicypt

42、hread_attr_getscopepthread_attr_setinheritschedpthread_attr_setschedpolicypthread_attr_setscopepthread_getschedparampthread_setschedparampthread_setschedprio(GLIBC_2.3.4)4.1.7.2 高级实时线程本标准中没有为libpthread定义高级实时线程外部函数接口。4.1.7.3 Posix线程表25 Posix线程函数接口_pthread_cleanup_pop_pthread_cleanup_pushpthread_attr_

43、destroypthread_attr_getdetachstatepthread_attr_getguardsizepthread_attr_getschedparampthread_attr_getstackpthread_attr_getstackaddrpthread_attr_getstacksizepthread_attr_initpthread_attr_setdetachstatepthread_attr_setguardsizepthread_attr_setschedparampthread_attr_setstackpthread_attr_setstackaddrpth

44、read_attr_setstacksizepthread_cancelpthread_cond_broadcastpthread_cond_destroypthread_cond_initpthread_cond_signalpthread_cond_timedwaitpthread_cond_waitpthread_condattr_destroypthread_condattr_getpsharedpthread_condattr_initpthread_condattr_setpsharedpthread_createpthread_detachpthread_equalpthread

45、_exitpthread_getconcurrencypthread_getspecificpthread_joinpthread_key_createpthread_key_deletepthread_killpthread_mutex_destroypthread_mutex_initpthread_mutex_lockpthread_mutex_trylockpthread_mutex_unlockpthread_mutexattr_destroypthread_mutexattr_getpsharedpthread_mutexattr_gettypepthread_mutexattr_

46、initpthread_mutexattr_setpsharedpthread_mutexattr_settypepthread_oncepthread_rwlock_destroypthread_rwlock_initpthread_rwlock_rdlockpthread_rwlock_timedrdlockpthread_rwlock_timedwrlockpthread_rwlock_tryrdlockpthread_rwlock_trywrlockpthread_rwlock_unlockpthread_rwlock_wrlockpthread_rwlockattr_destroyp

47、thread_rwlockattr_getpsharedpthread_rwlockattr_initpthread_rwlockattr_setpsharedpthread_selfpthread_setcancelstatepthread_setcanceltypepthread_setconcurrencypthread_setspecificpthread_sigmaskpthread_testcancelsem_closesem_destroysem_getvaluesem_initsem_opensem_postsem_timedwaitsem_trywaitsem_unlinks

48、em_wait4.1.7.4 libc接口中与线程相关的部分表26 libc接口中与线程相关的部分函数接口lseek64open64preadpread64pwritepwrite644.1.8 libpthread的数据定义。本条定义了以下头文件：pthread.hsemaphore.h这些头文件的详细内容见ISO/IEC 23360-1的基本库部分。4.1.9 libpthread的接口定义本标准没有对libpthread的接口进行扩充，4.1.7中表述的所有函数的详细描述见ISO/IEC 23360-1的基本库部分。4.1.10 libgcc_s接口本条规定了 Unwind库的接口。本标

49、准没有对Unwind库定义外部函数接口。4.1.11 libgcc_s的数据定义本条定义了以下头文件：unwind.h关于此头文件的详细内容见ISO/IEC 23360-1的基本库部分。4.1.12 libdl接口本条规定动态加载函数接口。表27 动态加载函数接口dladdrdlclosedlerrordlopendlsym 4.1.13 libdl的数据定义本条定义了头文件：dlfcn.h关于此头文件的详细内容见ISO/IEC 23360-1的基本库部分。4.1.14 libdl的接口定义本标准没有对libdl的接口进行扩充，4.1.12中表述的所有函数的详细描述见ISO/IEC 23360-1的基本库部分。4.1.15 Librt接口本条规定了以下接口：4.1.15.1 共享内存