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

FreeBSD Manual Pages

  
 
  

home | help
FNQUALIFY(3)		     C Programmer's Manual		  FNQUALIFY(3)

NAME
       fnqualify - qualify a filename

SYNOPSIS
       #include	<publib.h>

       size_t fnqualify(char *result, const char *path,	size_t max);

DESCRIPTION
       fname_qualify  qualifies	a filename.  This means	that if	the input name
       is not an absolute name (i.e. starts from the root directory,  e.g.  is
       foo,  not  /tmp/foo),  the  current  directory will be prepended	to it.
       Also, tilde conversion is done: if the filename	begins	with  a	 tilde
       (~),  the tilde is replaced with	the home directory of the user,	and if
       it begins with a	tilde and a username, both are replaced	with the  home
       directory of the	given user.

       Simplifications	like  replacing	 /./ with /, and /foo/../bar with /bar
       are not done because of problems	with symbolic links.

RETURNS
       The function returns -1 if there	was some error,	or the total  size  of
       the full	name otherwise.	 The return value may be greater than the max-
       imum size given by the last argument; only as much as allowed  by  that
       is actually written, though.

SEE ALSO
       publib(3), fname(3)

AUTHOR
       Lars Wirzenius (lars.wirzenius@helsinki.fi)

Publib			     C Programmer's Manual		  FNQUALIFY(3)

NAME | SYNOPSIS | DESCRIPTION | RETURNS | SEE ALSO | AUTHOR

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

home | help