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

SYNOPSIS
       #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  paths,  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)

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

home | help