gpp4  1.3.1
Functions
ccp4_program.c File Reference

Utilies to set and fetch program information. More...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include "ccp4_program.h"
#include "ccp4_parser.h"
#include "ccp4_utils.h"
#include "ccp4_general.h"

Functions

char * ccp4_prog_vers (const char *progvers)
 
char * ccp4ProgramName (const char *progname)
 
char * ccp4RCSDate (const char *rcs_string)
 
void ccp4ProgramTime (int init)
 
int ccp4VerbosityLevel (int level)
 
int ccp4Callback (CCP4INTFUNCPTR mycallback, char *mode, int ierr, char *message)
 
int ccp4SetCallback (CCP4INTFUNCPTR mycallback)
 
int ccp4InvokeCallback (int ierr, char *message)
 
int ccp4NullCallback (int level, char *message)
 
int ccp4_licence_exists (const char *name)
 
int html_log_output (int ihtml_in)
 
int summary_output (int isumm_in)
 

Detailed Description

Utilies to set and fetch program information.

Author
Peter Briggs
Date
May 2001

Function Documentation

int ccp4_licence_exists ( const char *  name)

Check existence of licence agreement

Parameters
nameName of licence, e.g. "CCP4".
Returns
always return 1. This is a dummy routine in gpp4.

Referenced by FORTRAN_SUBR().

char* ccp4_prog_vers ( const char *  progvers)

Register or query program version.

Parameters
progversProgram version string, or NULL to query existing value.
Returns
Program version string.

References MAXLEN_PROGVERSION.

Referenced by ccp4_banner(), ccp4fyp(), and FORTRAN_SUBR().

int ccp4Callback ( CCP4INTFUNCPTR  mycallback,
char *  mode,
int  ierr,
char *  message 
)

Set or invoke a user-defined callback function. Internal function: applications should use the API functions ccp4SetCallback and ccp4InvokeCallback

References ccp4NullCallback().

Referenced by ccp4InvokeCallback(), and ccp4SetCallback().

int ccp4InvokeCallback ( int  ierr,
char *  message 
)

Execute the user-defined callback function (previously set up using ccp4SetCallback) with the supplied arguments. This is a wrapper to ccp4Callback in "invoke" mode.

References ccp4Callback(), and ccp4NullCallback().

int ccp4NullCallback ( int  level,
char *  message 
)

Default null callback function Internal function: this is the default callback function used by ccp4Callback if no user-defined function has been specified.

Referenced by ccp4Callback(), and ccp4InvokeCallback().

char* ccp4ProgramName ( const char *  progname)

Set or return program name.

Parameters
prognameProgram name, or NULL to query existing value.
Returns
Program name

Always returns a pointer to the program name If progname is not NULL then set the program name to progname.

Note
Default program name will be returned as "CCP4", until reset by the calling subprogram.

References MAXLEN_PROGNAME.

Referenced by ccp4_banner(), ccp4fyp(), ccperror_noexit(), and FORTRAN_SUBR().

void ccp4ProgramTime ( int  init)

Set or print program time information

Parameters
initThe timer is started when this routine is called with a non-zero argument. When the routine is called with a 0 argument, timing information is printed to stdout.
Note
Only one timer can be handled.

References ccp4_utils_etime().

Referenced by ccp4fyp(), ccperror_noexit(), and FORTRAN_SUBR().

char* ccp4RCSDate ( const char *  rcs_string)

Set or return program RCS date

Parameters
rcs_stringDate string, or NULL to query existing value.
Returns
Date string

If the input string is not a NULL pointer then it is assumed to be an RCS string This is processed to extract a date string in the form "DD/MM/YY" (day/month/year), which is then stored.

ccp4RCSDate always returns the currently stored date string.

Note
This routine does not make sense in gpp4, since RCS idents are not expanede in the SCM system we are using.

References MAXLEN_RCSDATE.

Referenced by FORTRAN_SUBR().

int ccp4SetCallback ( CCP4INTFUNCPTR  mycallback)

Store a pointer to a user-defined callback function of the form "int func(int, char *)" This is a wrapper to ccp4Callback in "set" mode.

References ccp4Callback().

int ccp4VerbosityLevel ( int  level)

Set or return the reference verbosity level

Parameters
levelVerbosity level, or -1 to query existing value.
Returns
Verbosity level Always return the verbosity level - if verboselevel is between 0 and 9 then reset the verbosity level to verboselevel

Referenced by ccp4fyp(), ccp4printf(), and FORTRAN_SUBR().

int html_log_output ( int  ihtml_in)

Register or query html output level.

Parameters
ihtml_in0 = turn off html output, 1 = turn on html output, -1 = query existing value
Returns
0 = no html output, 1 = html output html_log_output and summary_output currently only used by ccperror to tidy up Fortran program output. Defaults are 0 for C programs.

Referenced by ccp4f_mem_tidy(), and ccperror_noexit().

int summary_output ( int  isumm_in)

Register or query summary output level.

Parameters
isumm_in0 = turn off summary output, 1 = turn on summary output, -1 = query existing value
Returns
0 = no summary output, 1 = summary output

Referenced by ccp4f_mem_tidy(), and ccperror_noexit().