xref: /illumos-gate/usr/src/lib/libexacct/demo/README (revision bbf21555)
17c478bd9Sstevel@tonic-gate#
27c478bd9Sstevel@tonic-gate# CDDL HEADER START
37c478bd9Sstevel@tonic-gate#
47c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
57c478bd9Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
67c478bd9Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
77c478bd9Sstevel@tonic-gate# with the License.
87c478bd9Sstevel@tonic-gate#
97c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
107c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
117c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
127c478bd9Sstevel@tonic-gate# and limitations under the License.
137c478bd9Sstevel@tonic-gate#
147c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
157c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
167c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
177c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
187c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
197c478bd9Sstevel@tonic-gate#
207c478bd9Sstevel@tonic-gate# CDDL HEADER END
217c478bd9Sstevel@tonic-gate#
227c478bd9Sstevel@tonic-gate
237c478bd9Sstevel@tonic-gateCopyright 2002 Sun Microsystems, Inc.  All rights reserved.
247c478bd9Sstevel@tonic-gateUse is subject to license terms.
257c478bd9Sstevel@tonic-gate
267c478bd9Sstevel@tonic-gate1. Introduction
277c478bd9Sstevel@tonic-gate
287c478bd9Sstevel@tonic-gateThis directory contains  source code for the "exdump"  utility that uses
297c478bd9Sstevel@tonic-gatelibexacct to print the content  of extended accounting files produced by
307c478bd9Sstevel@tonic-gatethe kernel.
317c478bd9Sstevel@tonic-gate
327c478bd9Sstevel@tonic-gateThis  utility   demonstrates  how  developers  can  use   the  libexacct
337c478bd9Sstevel@tonic-gateprogramming API to extract  extended accounting data. libexacct(3LIB) is
347c478bd9Sstevel@tonic-gatethe only interface for reading and  writing  files  in  variable  length
357c478bd9Sstevel@tonic-gategeneral-purpose accounting file format  used  by  the  kernel  to  store
367c478bd9Sstevel@tonic-gatevarious types of accounting data.
377c478bd9Sstevel@tonic-gate
387c478bd9Sstevel@tonic-gate2. Configuration
397c478bd9Sstevel@tonic-gate
407c478bd9Sstevel@tonic-gateExdump can be compiled as either a 32-bit or 64-bit application; because
417c478bd9Sstevel@tonic-gateexacct is endian-neutral, exdump can read exacct files from either SPARC
427c478bd9Sstevel@tonic-gateor Intel sources on SPARC or Intel platforms. exdump prints one line for
437c478bd9Sstevel@tonic-gateeach record it encounters in the exacct file.
447c478bd9Sstevel@tonic-gate
457c478bd9Sstevel@tonic-gateThe Makefile contained in this directory is set up to use the C compiler
467c478bd9Sstevel@tonic-gate(cc) and lint  utility found in your  $PATH.  If you wish  to change the
477c478bd9Sstevel@tonic-gateconfiguration, edit  the CC  and LINT macro  definitions in  Makefile to
487c478bd9Sstevel@tonic-gatepoint to the appropriate pathnames.
497c478bd9Sstevel@tonic-gate
507c478bd9Sstevel@tonic-gate3. Targets
517c478bd9Sstevel@tonic-gate
527c478bd9Sstevel@tonic-gateThe Makefile in this directory supports the following targets:
537c478bd9Sstevel@tonic-gate
547c478bd9Sstevel@tonic-gate	make all (default)	- build exdump executable
557c478bd9Sstevel@tonic-gate	make lint		- run lint against exdump
567c478bd9Sstevel@tonic-gate	make clean		- remove object files
577c478bd9Sstevel@tonic-gate	make clobber		- remove objects, and lint files
587c478bd9Sstevel@tonic-gate
597c478bd9Sstevel@tonic-gateTo  build the  exdump,  execute  "make" in  this  directory.  This  will
607c478bd9Sstevel@tonic-gateexecute the default "make all" target.
617c478bd9Sstevel@tonic-gate
627c478bd9Sstevel@tonic-gate4. References
637c478bd9Sstevel@tonic-gate
647c478bd9Sstevel@tonic-gateExacct files:	/var/adm/exacct/proc, /var/adm/exacct/task
65*bbf21555SRichard LoweMan pages:	acctadm(8), libexacct(3LIB)
667c478bd9Sstevel@tonic-gateDocumentation:	"System Administration Guide:
677c478bd9Sstevel@tonic-gate		Resource Management and Network Services"
687c478bd9Sstevel@tonic-gate		"System Administration Guide: IP Services"
69