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

FreeBSD Manual Pages

  
 
  

home | help
FILEPATH(3)		     MBK UTILITY FUNCTIONS		   FILEPATH(3)

NAME
       filepath	- return the whole search path of a file

SYNOPSYS
       #include	"mut.h"
       char *filepath(name, extension)
       char *name, *extension;

PARAMETERS
       name		   Name	of the file to be search for

       extension	   File	extension

DESCRIPTION
       filepath	 return	the absolute path of a cell.  This is useful for error
       messages, since the caller of mbk file functions	is not able to specify
       explicitly  which  file	it opened.  Having such	an information is also
       necessary when last modification	times or access	times are  needed,  as
       for  consistency	 checks.  The file is searched through the environment
       variable	MBK_WORK_LIB(1), and if	not found, through MBK_CATA_LIB(1)  in
       the user	defined	order.
       The  file  to be	searched is called name.extension, if extension	is not
       NULL, else it is	name. If extension is the empty	string,	"",  then  the
       file name will be name. .

RETURN VALUE
       filepath	 returns NULL on failure, ie the file is not in	the pathes, or
       the absolute path on success.  The value	returned, when	not  NULL,  is
       stored  in  a static buffer, so this values is to use at	return time or
       copied into a user buffer.

EXAMPLE
       #include	<stdio.h>
       #include	"mut.h"
       #include	"mph.h"
       void vti_error(fig, error)
       phfig_list *fig;
       char *(*error)();
       {
	     fprintf(stderr, "Syntax error in %s\n", filepath(fig->NAME, "cp"));
	     fprintf(stderr, "%s\n", error());
       }

SEE ALSO
       mbk(1), MBK_WORK_LIB(1),	MBK_CATA_LIB(1), mbkfopen(3).  mbkunlink(3).

ASIM/LIP6			October	1, 1997			   FILEPATH(3)

NAME | SYNOPSYS | PARAMETERS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=filepath&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help