Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GETPHFIG(3)		MBK PHYSICAL UTILITY FUNCTIONS		   GETPHFIG(3)

NAME
       getphfig	- give back a pointer to a phfig

SYNOPSIS
       #include	"mph.h"
       phfig_list *getphfig(figname, mode)
       char *figname;
       char mode;

PARAMETERS
       figname		   Name	of the figure to be created mode Demanded mode
			   for the figure

DESCRIPTION
       getphfig	 returns  a pointer to the figure called figname with the war-
       ranty that the expected information is present in memory.
       If mode is 'A' then the figure has all its lists	filled,	else the  fig-
       ure may either be complete or interface only.
       This  function  allows  to completely mask disk access for applications
       programs. If the	figure is in memory, with the specified	mode, then the
       function	returns	the appropriate	pointer. Else, the function performs a
       call to the loadphfig(3)	and returns a pointer to the loaded figure.

RETURN VALUE
       getphfig	returns	a pointer to the wanted	figure.

ERRORS
       getphfig	cannot give any	errors,	but the	subsequent calls  it  performs
       to  parsers  do.	 So the	source of trouble may be the call to getphfig.
       See loadphfig(3)	for details.

EXAMPLE
       #include	"mph.h"
       phfig_list *na2_y()
       {
	  /* find in memory or load from disk na2_y */
	  return getphfig("na2_y", 'A');
       }

SEE ALSO
       mbk(1), phfig(3), addphfig(3), delphfig(3), loadphfig(3), savephfig(3),
       flattenphfig(3),	rflattenphfig(3).

ASIM/LIP6			October	1, 1997			   GETPHFIG(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=getphfig&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help