（C++通讯架构学习笔记）：日志打印、优化main函数调用顺序

目录

基础设施之日志打印

设置时区

日志等级划分

捋顺main函数中代码执行顺序

基础设施之日志打印

• 日志的重要性：供日后运行维护人员去查看、定位和解决问题
• ngx_printf.cxx：放和打印格式相关的函数
• ngx_log.cxx：放和日志相关的函数

【ngx_log_stderr()  】

• ngx_log_stderr()  :三个特殊文件描述符，谈到了标准错误 STDERR_FILENO，代表屏幕
• ngx_log_stderr()：往屏幕上打印一条错误信息，功能类似于printf
  • printf("mystring=%s,myint=%d，%d","mytest",15,20)。
    • (1)根据可变的参数，组合出一个字符串:mystring=mytest,myint=15，20。
    • (2)往屏幕上显示出这个组合出来的字符串。
• ngx_log_stderr()：可以支持任意我们想支持的格式化字符 %d， %f，对于扩展原有功能非常有帮助。

【示例】

• 函数调用关系

(i)void ngx_log_stderr(int err, const char *fmt, ...)
(i)    p = ngx_vslprintf(p,last,fmt,args); //实现了自我可定制的printf类似的功能
(i)        buf = ngx_sprintf_num(buf, last, ui64, zero, hex, width);
(i)    p = ngx_log_errno(p, last, err);

• 在main函数中调用 

设置时区

• 我们要设置成CST时区，以保证日期，时间显示的都正确
• 我们常看到的时区，有如下几个：
  • PST【PST美国太平洋标准时间】 = GMT - 8;
  • GMT【格林尼治平均时间Greenwich Mean Time】等同于英国伦敦本地时间
  • UTC【通用协调时Universal Time Coordinated】 = GMT
  • CST【北京时间：北京时区是东八区，领先UTC八个小时】

【更改时区方式】

• 输入命令：tzselect

• 【注意】还需要拷贝生成的文件

cp /usr/share/zoneinfo/Asia/Shanghai  /etc/localtime

日志等级划分

• 划分日志等级，一共分8级，分级的目的是方便管理，显示，过滤等等
• 日志级别从高到低，数字最小的级别最高，数字最大的级别最低

【日志等级定义】

• nginx.conf文件中进行配置

• ngx_log.cxx

//描述：日志初始化，就是把日志文件打开 ，注意这里边涉及到释放的问题，如何解决？
void ngx_log_init()
{
    u_char *plogname = NULL;
    size_t nlen;

    //从配置文件中读取和日志相关的配置信息
    CConfig *p_config = CConfig::GetInstance();
    plogname = (u_char *)p_config->GetString("Log");
    if(plogname == NULL)
    {
        //没读到，就要给个缺省的路径文件名了
        plogname = (u_char *) NGX_ERROR_LOG_PATH; //"logs/error.log" ,logs目录需要提前建立出来
    }
    ngx_log.log_level = p_config->GetIntDefault("LogLevel",NGX_LOG_NOTICE);//缺省日志等级为6【注意】 ，如果读失败，就给缺省日志等级
    //nlen = strlen((const char *)plogname);

    //只写打开|追加到末尾|文件不存在则创建【这个需要跟第三参数指定文件访问权限】
    //mode = 0644：文件访问权限， 6: 110    , 4: 100：     【用户：读写， 用户所在组：读，其他：读】 
    ngx_log.fd = open((const char *)plogname,O_WRONLY|O_APPEND|O_CREAT,0644);  
    if (ngx_log.fd == -1)  //如果有错误，则直接定位到 标准错误上去 
    {
        ngx_log_stderr(errno,"[alert] could not open error log file: open() \"%s\" failed", plogname);
        ngx_log.fd = STDERR_FILENO; //直接定位到标准错误去了        
    } 
    return;
}

• main函数中进行调用

• nginx_global.h

• nginx.cxx

捋顺main函数中代码执行顺序

//本文件用的函数声明
static void freeresource();

//和设置标题有关的全局量
char **g_os_argv;            //原始命令行参数数组,在main中会被赋值
char *gp_envmem = NULL;      //指向自己分配的env环境变量的内存，在ngx_init_setproctitle()函数中会被分配内存
int  g_environlen = 0;       //环境变量所占内存大小

//和进程本身有关的全局量
pid_t ngx_pid;               //当前进程的pid

int main(int argc, char *const *argv)
{   
    int exitcode = 0;           //退出代码，先给0表示正常退出

    //(1)无伤大雅也不需要释放的放最上边    
    ngx_pid = getpid();         //取得进程pid
    g_os_argv = (char **) argv; //保存参数指针    

    //(2)初始化失败，就要直接退出的
    //配置文件必须最先要，后边初始化啥的都用，所以先把配置读出来，供后续使用 
    CConfig *p_config = CConfig::GetInstance(); //单例类
    if(p_config->Load("nginx.conf") == false) //把配置文件内容载入到内存        
    {        
        ngx_log_stderr(0,"配置文件[%s]载入失败，退出!","nginx.conf");
        //exit(1);终止进程，在main中出现和return效果一样 ,exit(0)表示程序正常, exit(1)/exit(-1)表示程序异常退出，exit(2)表示表示系统找不到指定的文件
        exitcode = 2; //标记找不到文件
        goto lblexit;
    }
    
    //(3)一些初始化函数，准备放这里
    ngx_log_init();             //日志初始化(创建/打开日志文件)


    //(4)一些不好归类的其他类别的代码，准备放这里
    ngx_init_setproctitle();    //把环境变量搬家

    
    //--------------------------------------------------------------    
    for(;;)
    //for(int i = 0; i < 10;++i)
    {
        sleep(1); //休息1秒        
        printf("休息1秒\n");        

    }
      
    //--------------------------------------
lblexit:
    //(5)该释放的资源要释放掉
    freeresource();  //一系列的main返回前的释放动作函数
    printf("程序退出，再见!\n");
    return exitcode;
}

//专门在程序执行末尾释放资源的函数【一系列的main返回前的释放动作函数】
void freeresource()
{
    //(1)对于因为设置可执行程序标题导致的环境变量分配的内存，我们应该释放
    if(gp_envmem)
    {
        delete []gp_envmem;
        gp_envmem = NULL;
    }

    //(2)关闭日志文件
    if(ngx_log.fd != STDERR_FILENO && ngx_log.fd != -1)  
    {        
        close(ngx_log.fd); //不用判断结果了
        ngx_log.fd = -1; //标记下，防止被再次close吧        
    }
}