tt_spec_file(3)

tt_spec_file(3)	       C LIBRARY FUNCTIONS	  tt_spec_file(3)

NAME
     tt_spec_file - retrieve the name of the file  that	 contains
     the object	described by the spec

SYNOPSIS
     #include <Tt/tt_c.h>

     char *tt_spec_file(const char *objid);

DESCRIPTION
     The tt_spec_file()	function retrieves the name of	the  file
     that contains the object described	by the spec.

     The objid argument	is the identifier of the object	 involved
     in	this operation.

RETURN VALUE
     Upon  successful  completion,  the	 tt_spec_file()	 function
     returns  the absolute pathname of the file.  The application
     can use tt_ptr_error(3) to	 extract  one  of  the	following
     Tt_status values from the returned	pointer:

	TT_OK	The operation completed	successfully.

	TT_ERR_DBAVAIL
		The ToolTalk service could not access  the  Tool-
		Talk database needed for this operation.

	TT_ERR_DBEXIST
		The ToolTalk service could not access the  speci-
		fied ToolTalk database in the expected place.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_OBJID
		The objid passed to the	ToolTalk service does not
		reference an existing object spec.

APPLICATION USAGE
     The application should  use  tt_free(3)  to  free	any  data
     stored in the address returned by the ToolTalk API.

SEE ALSO
     Tttt_c(5),	tt_ptr_error(3), tt_free(3).

Unix System LaboratorLast change: 11 May 1994			1