libvips/man/im_guess_prefix.3

39 lines
1.1 KiB
Groff

.TH IM_VIPSHOME 3 "8 March 2001"
.SH NAME
im_guess_prefix, im_guess_libdir \- try to guess install directory
.SH SYNOPSIS
.B #include <vips/vips.h>
.B const char *im_guess_prefix( const char *argv0,
.B const char *env_name )
.B const char *im_guess_libdir( const char *argv0,
.B const char *env_name )
.SH DESCRIPTION
.B im_guess_prefix(3)
tries to guess the install directory. You should pass in the value of
argv[0] (the name your program was run as) as a clue to help it out, plus
the name of the environment variable you let the user override your package
install area with (eg. "VIPSHOME").
On success,
.B im_guess_prefix(3)
returns the prefix it discovered, and as a side effect, sets the environment
variable (if it's not set).
.B im_guess_prefix(3)
is useful for programs in the VIPS distribution and contrib which need to be
able to find data files.
Don't free the return string!
.B im_guess_libdir(3)
works exactly as
.B im_guess_prefix(3)
but, if vips has not been moved since configure, returns the libdir configure
setting. If vips has been moved, it returns prefix/lib.
.SH RETURN VALUE
The function returns NULL on failure.