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 mes- sages, since the caller of mbk file functions is not able to specify ex- plicitly which file it opened. Having such an information is also neces- sary when last modification times or access times are needed, as for con- sistency 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 de- fined 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)
NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO
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.1.quarterly>