GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  VCP::LOGGER (3)

.ds Aq ’

NAME

VCP::Logger - Update message, bug, and Log file management

CONTENTS

SYNOPSIS



   use VCP::Logger qw( shell_quote );



DESCRIPTION

Does not throw exceptions or use the debug module, so this is safe to use with both. Load this as the very first module in your program.

The log file name defaults to vcp.log, set the environment variable VCPLOGFILE to change it. Here’s how to do this in your program:



   BEGIN {
      $ENV{VCPLOGFILE} = "foo.bar"
         unless defined $ENV{VCPLOGFILE} || length $ENV{VCPLOGFILE};
   }



FUNCTIONS

lg Prints a timestamped message to the log. Adds a trailing newline if need be. The first word of the message should not be capitalized unless it’s a name or acronym; this makes grepping a bit easier (same for all error messages).

lg is log abbreviated so as not to conflict with Perl’s builtin log().

The timestamps are in integer seconds since this module was compiled unless you have Time::HiRes install in which case they are in floating point seconds.

Should not throw an exception or alter $@ in the normal course of events (does not call any routines that should do so).

lg_fh Returns a reference to the log filehandle (*LOG{IO}) so you can emit to the log directly. The log is flushed after every write, so this should be quite safe.
pr Print a status notification to STDERR (unless in quiet mode) and log it.
pr_doing


   pr_doing "Fooo";
   pr_doing "Fooo", { ...options... };
   pr_doing;  ## to show progress



Print a status notification and show progress. Call repeatedly to show continuing progress. Works with pr() to manage lineends.

Call with no parameters to show progress on the current task. Call pr_done or pr_done_failed to finish up.

Options:



    Expect   => $c, # There should be this number of calls, total, not
                    # including the call with the options set..



pr_did


    pr_did $what, $status;



Adds a message to the progress bar, does not affect progress otherwise.

Useful to display additional progress metrics.

Call before pr_doing.

pr_active Show that we’re active.
pr_done Called to end a pr_doing sucessfully. Logs the completion bug does not emit to STDERR. Prints and logs any message passed.
p4_done_failed Called to end a pr_doing in dismal failure. Logs the (in)completion and and emits a message to the log and STDERR if one is passed.
BUG Reports a bug using Carp::confess and logging the information.
set_quiet_mode


    set_quiet_mode;
    set_quiet_mode( 1 );
    set_quiet_mode( 0 );



Called to quash (or allow) progress bars. See the --quiet option on the command line.

start_time Returns the time the application started. This is a floating point number if Time::HiRes was found.

COPYRIGHT

Copyright 2000, Perforce Software, Inc. All Rights Reserved.

This module and the VCP package are licensed according to the terms given in the file LICENSE accompanying this distribution, a copy of which is included in vcp.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 VCP::LOGGER (3) 2004-11-04

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.