NAME

Mail::Box::Locker::Mutt - lock a folder using mutt_dotlock

INHERITANCE

Mail::Box::Locker::Mutt
  is a Mail::Box::Locker
  is a Mail::Reporter

SYNOPSIS

See Mail::Box::Locker

DESCRIPTION

The mutt mail reader includes an separate program which is specialized in locking folders. This locker class uses this external program. Mutt is not automatically installed.

METHODS

$obj->exe

Returns the name of the external binary.

Constructors

Mail::Box::Locker::Mutt->new(OPTIONS)

Option   Defined in       Default        
exe                       C<mutt_dotlock>
expires  L<Mail::Box::Locker>  1 hour         
file     L<Mail::Box::Locker>  undef          
folder   L<Mail::Box::Locker>  <required>     
log      L<Mail::Reporter>  C<'WARNINGS'>  
method   L<Mail::Box::Locker>  C<'DOTLOCK'>   
timeout  L<Mail::Box::Locker>  10 seconds     
trace    L<Mail::Reporter>  C<'WARNINGS'>  

. exe PATH

The name of the program. May be a relative or absolute path.

. expires SECONDS

. file FILENAME

. folder FOLDER

. log LEVEL

. method STRING|CLASS|ARRAY

. timeout SECONDS|'NOTIMEOUT'

. trace LEVEL

The Locker

$obj->filename([FILENAME])

See "The Locker" in Mail::Box::Locker

$obj->folder

See "The Locker" in Mail::Box::Locker

$obj->name

See "The Locker" in Mail::Box::Locker

Locking

$obj->hasLock

See "Locking" in Mail::Box::Locker

$obj->isLocked

See "Locking" in Mail::Box::Locker

$obj->lock

$obj->unlock

Error handling

$obj->AUTOLOAD

See "Error handling" in Mail::Reporter

$obj->addReport(OBJECT)

See "Error handling" in Mail::Reporter

$obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])

Mail::Box::Locker::Mutt->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])

See "Error handling" in Mail::Reporter

$obj->errors

See "Error handling" in Mail::Reporter

$obj->log([LEVEL [,STRINGS]])

Mail::Box::Locker::Mutt->log([LEVEL [,STRINGS]])

See "Error handling" in Mail::Reporter

$obj->logPriority(LEVEL)

Mail::Box::Locker::Mutt->logPriority(LEVEL)

See "Error handling" in Mail::Reporter

$obj->logSettings

See "Error handling" in Mail::Reporter

$obj->notImplemented

See "Error handling" in Mail::Reporter

$obj->report([LEVEL])

See "Error handling" in Mail::Reporter

$obj->reportAll([LEVEL])

See "Error handling" in Mail::Reporter

$obj->trace([LEVEL])

See "Error handling" in Mail::Reporter

$obj->warnings

See "Error handling" in Mail::Reporter

Cleanup

$obj->DESTROY

See "Cleanup" in Mail::Box::Locker

$obj->inGlobalDestruction

See "Cleanup" in Mail::Reporter

DIAGNOSTICS

Warning: Couldn't remove mutt-unlock $folder: $!

Error: Failed to remove expired mutt-lock $lockfile: $!

Warning: Folder $folder already mutt-locked

Error: Package $package does not implement $method.

Fatal error: the specific package (or one of its superclasses) does not implement this method where it should. This message means that some other related classes do implement this method however the class at hand does not. Probably you should investigate this and probably inform the author of the package.

Warning: Removed expired mutt-lock $lockfile

REFERENCES

See the MailBox website at http://perl.overmeer.net/mailbox/ for more details.

COPYRIGHTS

Distribution version 2.065. Written by Mark Overmeer (mark@overmeer.net). See the ChangeLog for other contributors.

Copyright (c) 2001-2003 by the author(s). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.