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

FreeBSD Manual Pages

  
 
  

home | help
VENTI-LOG(3)		   Library Functions Manual		  VENTI-LOG(3)

NAME
       VtLog, VtLogChunk, vtlog, vtlogclose, vtlogdump,	vtlognames, vtlogopen,
       vtlogprint, vtlogremove,	vtlogopen, ventilogging	- Venti	logs

SYNOPSIS
       #include	<u.h>
       #include	<libc.h>
       #include	<venti.h>

       VtLog* vtlogopen(char *name, uint size);

       void   vtlogprint(VtLog *log, char *fmt,	...);

       void   vtlogclose(VtLog *log);

       void   vtlog(char *name,	char *fmt, ...);

       void   vtlogremove(char *name);

       char** vtlognames(int *n);

       void   vtlogdump(int fd,	VtLog *log);

       extern int ventilogging;	   /* default 0	*/

       extern char *VtServerLog;    /* "libventi/server" */

DESCRIPTION
       These routines provide an in-memory circular log	structure used by  the
       Venti  library and the Venti server to record events for	debugging pur-
       poses.  The logs	are named by UTF strings.

       Vtlogopen returns a reference to	the log	with the given name  .	 If  a
       log  with that name does	not exist and size is non-zero,	vtlogopen cre-
       ates a new log capable of holding at least size bytes and  returns  it.
       Vtlogclose releases the reference returned by vtlogopen.

       Vtlogprint writes to log, which must be open.

       Vtlog is	a convenient packaging of vtlogopen followed by	vtlogprint and
       vtlogclose.

       Vtlogremove removes the log with	the given name,	freeing	any associated
       storage.

       Vtlognames  returns a list of the names of all the logs.	 The length of
       the list	is returned in *n.  The	list should be freed by	calling	vtfree
       on the returned pointer.	 The strings in	the list will be freed by this
       call as well.  (It is an	error to call vtfree on	any of the strings  in
       the list.)

       Vtlogdump prints	log, which must	be open, to the	file descriptor	fd.

       If  ventilogging	is set to zero (the default), vtlognames and vtlogdump
       can inspect existing logs, but vtlogopen	always returns nil  and	 vtlog
       is  a no-op.  The other functions are no-ops when passed	nil log	struc-
       tures.

       The server  library  (see  venti-conn(3)	 and  venti-server(3))	writes
       debugging  information  to the log named	VtServerLog, which defaults to
       the string `libventi/server'.

SOURCE
       /usr/local/plan9/src/libventi

SEE ALSO
       venti(3), venti(8)

								  VENTI-LOG(3)

NAME | SYNOPSIS | DESCRIPTION | SOURCE | SEE ALSO

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

home | help