本文通過實現一個“建立C語言標頭檔案和原始檔模板”的dn命令作為例子演示linux中實現帶引數的命令過程。

第一步：實現命令原始碼：

/**********************************************************    
FileName : dn.c 
FileFunc : Linux下實現.c和.h檔案模板    
Version  : V0.1     
Author   : qiuyigui     
Date     : 2013-03-30
Descp    : Linux下實現命令列實用程式   
*************************************************************/ 
#include <stdio.h>  
#include <stdlib.h>  
#include <string.h>  
#include <time.h>  

void GetLocalTime( char *pOutTime ); 
unsigned char createfile( unsigned char ucFileFlag,char *pFilename ); 
void StrToUpper( char *pcStr ); 
void write_h( FILE *fp ,char *pFileName,char *pAliasName); 
void write_c( FILE *fp,char *pFileName ); 

void GetLocalTime( char *pOutTime )   
{   
time_t t;   
struct tm tm1;   
t = time(NULL);   
memcpy(&tm1,localtime(&t),sizeof(struct tm));   
sprintf(pOutTime,"%04d-%02d-%02d %02d:%02d:%02d",tm1.tm_year+1900,tm1.tm_mon+1,tm1.tm_mday,tm1.tm_hour,tm1.tm_min,tm1.tm_sec);   
/*YYYYMMDDHHMMSS(年月日時分秒)   */ 
}   

void StrToUpper( char *pcStr ) 
{ 
while( '\0'!=*pcStr ) 
{ 
    if( islower(*pcStr) ) 
    *pcStr -= 32;  
    ++pcStr; 
} 
} 

int main( int argc,char *argv[] )   
{ 
unsigned char ucRetCode = 1; 
 
if( 2==argc )   
{   
    if( 0==memcmp(argv[1],"--help",strlen(argv[1])) ) 
    { 
        fprintf(stderr,"用法:dn 選項... 檔案... \n"); 
        fprintf(stderr,"根據<選項>引數的設定來選擇建立指定的<檔案>是.h檔案還是.c檔案。\n"); 
        fprintf(stderr,"\n<選項>    <檔案> 引數的設定\n"); 
        fprintf(stderr,"-h  filename        建立名為filename.h檔案\n"); 
        fprintf(stderr,"-c  filename        建立名為filename.c檔案\n"); 
        fprintf(stderr,"--help              顯示此幫助資訊並退出\n"); 
        fprintf(stderr,"--version           輸出版本資訊並退出\n"); 
        fprintf(stderr,"\n如遇到問題,請向 <

[email protected]> 報告錯誤。\n"); 
    } 
    else if( 0==memcmp(argv[1],"--version",strlen(argv[1])) ) 
    { 
        fprintf(stderr,"create (free code) 1.01\n"); 
        fprintf(stderr,"這是自由軟體,相互交流學習可以加入QQ:58114361\n"); 
        fprintf(stderr,"\n"); 
        fprintf(stderr,"由qiuyigui編寫\n"); 
    } 
    else 
    { 
        fprintf(stderr,"%s:無效選項\"%s\"   \n",argv[0],argv[1]); 
        fprintf(stderr,"請嘗試執行 \"dn --help\" 來獲取更多的資訊. \n"); 
    }              
     
    exit (1);   
}   

if( 3!=argc ) 
{ 
    fprintf(stderr,"%s:無效選項  \n",argv[0]); 
    fprintf(stderr,"請嘗試執行 \"dn --help\" 來獲取更多的資訊. \n"); 
    exit (1); 
} 
 
if( '-'==*argv[1]) 
{    
    if( 0==memcmp(argv[1],"-h",strlen(argv[1])) ) 
    {    
        ucRetCode = createfile(0,argv[2]); 
    }    
    else if( 0==memcmp(argv[1],"-c",strlen(argv[1])) ) 
    {    
        ucRetCode = createfile(1,argv[2]);                   
    }    
    else 
    { 
        fprintf(stderr,"%s:無效選項\"%s\"  \"%s\" \n",argv[0],argv[1],argv[2]); 
        fprintf(stderr,"請嘗試執行 \"dn --help\" 來獲取更多的資訊. \n");  
        exit(1); 
    }    
     
} 
else 
{ 
    fprintf(stderr,"%s:無效選項\"%s\"  \"%s\" \n",argv[0],argv[1],argv[2]); 
    fprintf(stderr,"請嘗試執行 \"dn --help\" 來獲取更多的資訊. \n");  
    exit(1); 
}    
 
return ucRetCode; 
} 

unsigned char createfile(unsigned char ucFileFlag,char *pFilename) 
{ 
unsigned char ucRetCode = 1; 
char szFileName[30]; 
char szAliasName[30]; 
 
FILE *fp = NULL; 
unsigned int uiI; 
 
if( strlen(pFilename)>27 ) 
{ 
    fprintf(stderr,"%s:建立檔案失敗,檔名長度太長!\n",pFilename); 
    return 1; 
}     
 
memset(szFileName,0,sizeof(szFileName)); 
 
if( !ucFileFlag ) 
{    
    sprintf(szFileName,"%s.h",pFilename); 
} 
else 
{ 
    sprintf(szFileName,"%s.c",pFilename); 
}    
 
memset(szAliasName,0,sizeof(szAliasName)); 
sprintf(szAliasName,"%s",pFilename); 
StrToUpper(szAliasName); 
fp = fopen(szFileName,"r"); 
if( NULL!=fp ) 
{ 
    fclose(fp); 
    fprintf(stderr,"%s:建立檔案失敗,你指定的檔名當前目錄下已經存在!\n",pFilename); 
    return 1; 
}    
 
fp = NULL; 
fp = fopen(szFileName,"a"); 
if( NULL==fp ) 
{ 
    fprintf(stderr,"%s:建立檔案失敗!\n",pFilename); 
    return 1; 
} 
if( !ucFileFlag ) 
{ 
    write_h(fp,szFileName,szAliasName); 
} 
else 
{ 
    write_c(fp,szFileName); 
}    
fclose(fp); 
 
return 0; 
} 

void write_h( FILE *fp ,char *pFileName,char *pAliasName ) 
{ 
char szTime[30]; 
 
memset(szTime,0,sizeof(szTime)); 
GetLocalTime(szTime); 
fprintf(fp,"/*************************************************************\n"); 
fprintf(fp,"    FileName : %s \n",pFileName); 
fprintf(fp,"    FileFunc : 定義標頭檔案  \n"); 
fprintf(fp,"    Version  : V0.1  \n"); 
fprintf(fp,"    Author   : Sunrier  \n"); 
fprintf(fp,"    Date     : %s \n",szTime); 
fprintf(fp,"    Descp    : Linux下標頭檔案 \n"); 
fprintf(fp,"*************************************************************/\n"); 
fprintf(fp,"#ifndef   __%s_H__\n",pAliasName); 
fprintf(fp,"#define   __%s_H__\n",pAliasName); 
fprintf(fp,"\n"); 
fprintf(fp,"#ifdef __cplusplus\n"); 
fprintf(fp,"extern \"C\" {\n"); 
fprintf(fp,"#endif\n"); 
fprintf(fp,"\n\n\n\n"); 
fprintf(fp,"#ifdef __cplusplus\n"); 
fprintf(fp,"}\n"); 
fprintf(fp,"#endif\n"); 
fprintf(fp,"\n"); 
fprintf(fp,"#endif\n");          
 
} 

void write_c( FILE *fp,char *pFileName ) 
{ 
char szTime[30]; 
 
memset(szTime,0,sizeof(szTime)); 
GetLocalTime(szTime); 
fprintf(fp,"/*************************************************************\n"); 
fprintf(fp,"    FileName : %s \n",pFileName); 
fprintf(fp,"    FileFunc : 定義實現檔案  \n"); 
fprintf(fp,"    Version  : V0.1  \n"); 
fprintf(fp,"    Author   : Sunrier  \n"); 
fprintf(fp,"    Date     : %s \n",szTime); 
fprintf(fp,"    Descp    : Linux下實現檔案 \n"); 
fprintf(fp,"*************************************************************/\n"); 
fprintf(fp,"#include <stdio.h>\n"); 
fprintf(fp,"\n"); 
fprintf(fp,"int main(int argc,char *argv[])\n"); 
fprintf(fp,"{\n"); 
fprintf(fp,"\n\n"); 
fprintf(fp,"    return 0;\n"); 
fprintf(fp,"}\n"); 
fprintf(fp,"\n"); 
}

第二步：建立man手冊文件：

.\"表示:行首註釋  而\":表示在行中的註釋
.\":dn命令程式手冊頁的例項
.TH DN 1 "2013-03-30" "dn 1.01" "User Commands"
.\"DN:表示標題
.\"1:表示此命令出現在手冊頁的第幾部分,範圍為1-8的數字,和定義這個檔名小數點後的數字一致
.\""2013-03-30":表示"2013-03-30"顯示在整個頁的下中
.\""dn 1.01":表示"dn 1.01"顯示在整個頁的左下
.\""User Commands":表示"User Commands"顯示在整個頁的上中
.\".TH在檔案的開始,主要說明標題
.SH NAME
.\"說明名稱
.\".SH從行首開始,靠左邊,寬體
\fBdn\fR \- A simple demonstration application creates a file that head file or c file .
.\"-:表示為\-
.SH SYNOPSIS
.\"說明語法格式
.B dn
.\".B:表示寬體,如果本行沒有文字,則.B標籤的下一行為寬體
\-OPTION... FILE...
.SH DESCRIPTION
.\"說明本命令或程式等的相關描述
This manual page document is from qiuyigui . \fBdn\fR is a common application for create a new file that .c or .h file .
.\"\fB文字\fR:表示將該文字設定成寬體
.\"\fI文字\fR:表示將文字加下劃線
.\".:表示為\&.
.SH OPTIONS
.\"說明引數選項設定
It will decide to create a .h file or .c file
.sp
.\".sp:表示空行
.B \-h
It will create a new head file
.sp
.B \-c
It will create a new c file
.sp
.B \-\-help
display this help and exit
.sp
.B \-\-version
output version information and exit
.SH COPYRIGHT
.\":版權宣告
\fBdn\fR is Copyright qiuyigui .This program is free  software ,you can redistribute it or modify it under the GNU General Public License as published by the free software foundation .
.SH SEE ALSO
.\":其他參考
This program is a template of c and h files to quickly create .
.SH REPORTING BUGS
.\":漏洞說明
.TP 0
.\".TP n:表示TP標籤下的第2行開始縮排n個字元(在第1行超過n字元的前提下)　n預設值為7
.\".TP 0:表示Report bugs to <[email protected]> .這一句縮排0個字元,這句即為了實現換行的作用
There probably are some,but I don't know that what they are yet.
Report bugs to <qiuyigui@gmail.com> .
.SH AUTHOR
.\":文件編寫作者
Written by qiuyigui .

.\"看顯示建立man手冊命令的結果groff -Tascii -man dn.1(注:此時不會建立任務檔案,只是看下顯示效果)
.\"gzip dn.1 把dn.1壓縮成.gz 檔案,會建立一個dn.1.gz的檔案,而dn.1檔案會在gzip執行完後刪除
.\"如果想保留原檔案可以這樣用:gzip -c dn.1 > dn.1.gz
.\"把檔案dn.1.gz放到/usr/share/man/man1下就可以完成dn命令的man手冊了
.\"當執行man dn後還會在在/var/cache/man/cat1/dn.1.bz2建立一個dn.1.bz2壓縮檔案

第三步：建立Makefile,內容如下：

#makefile  
OBJS = dn 
all:$(OBJS)   
CFLAGS = -O -w -ansi      
#CFLAGS = -O -Wall -ansi      
CC = gcc $(CFLAGS) 
 
dn:dn.c   
 @$(CC) -o [email protected] $?  
 @gzip -c dn.1 > dn.1.gz  
 @mv dn.1.gz /usr/share/man/man1 
#gzip壓縮成.gz 檔案  
#gzip不加引數時,預設壓縮檔案時,不儲存原來的檔案;  
#如gzip create.1 結果只有壓縮檔案create.1.gz,原檔案create.1沒有了.  
clean: 
 @ls | grep -v ^makefile$$ | grep -v [.]c$$ | grep -v [.]h$$ | grep -v [.]1$$ | grep -v [.]txt$$ | xargs rm -rf 
#makefile

第四步：Make生成dn二進位制執行檔案

第五步：例項：

[email protected]:/opt/work/dn# ./dn --version
create (free code) 1.01
這是自由軟體,相互交流學習可以加入QQ:58114361

由qiuyigui編寫

把dn檔案放入/usr/bin下可以省去前面的"./"