NAME

       shishi_realm_default_guess - API function

SYNOPSIS

       #include <shishi.h>

       char * shishi_realm_default_guess();

DESCRIPTION

       Guesses  a realm based on getdomainname(), which really responds with a NIS/YP domain, but
       if set properly, it might  be  a  good  first  guess.   If  this  NIS  query  fails,  call
       gethostname(),  and  on  its  failure,  fall  back  to  returning  the  artificial  string
       "could-not-guess-default-realm".

       Note that the hostname is not trimmed off of the string returned  by  gethostname(),  thus
       pretending  the  local  host  name is a valid realm name.  The resulting corner case could
       merit a check that the suggested realm is distinct from the fully qualifies host,  and  if
       not,  simply  strip  the  host  name  from  the  returned  string  before it is used in an
       application.  One reason for sticking with the present behaviour,  is  that  some  systems
       respond with a non-qualified host name as reply from gethostname().

RETURN VALUE

       Returns  a  guessed  realm  for  the  running  host,  containing  a  string that has to be
       deallocated with free() by the caller.

REPORTING BUGS

       Report     bugs     to     <bug-shishi@gnu.org>.      GNU      Shishi      home      page:
       http://www.gnu.org/software/shishi/      General      help     using     GNU     software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright © 2002-2022 Simon Josefsson.
       Copying and distribution of this file, with or without modification, are permitted in  any
       medium without royalty provided the copyright notice and this notice are preserved.

SEE ALSO

       The  full  documentation  for  shishi  is maintained as a Texinfo manual.  If the info and
       shishi programs are properly installed at your site, the command

              info shishi

       should give you access to the complete manual.