Processes(3) User Contributed Perl Documentation Processes(3)NAME
Mac::Processes - Macintosh Toolbox Interface to Process Manager
SYNOPSIS
use Mac::Processes;
while ( ($psn, $psi) = each(%Process) ) {
print "$psn\t",
$psi->processName, " ",
$psi->processNumber, " ",
$psi->processType, " ",
$psi->processSignature, " ",
$psi->processSize, " ",
$psi->processMode, " ",
$psi->processLocation, " ",
$psi->processLauncher, " ",
$psi->processLaunchDate, " ",
$psi->processActiveTime, " ",
$psi->processAppSpec, "\n";
}
DESCRIPTION
Access to Inside Macintosh is essential for proper use of these
functions. Explanations of terms, processes and procedures are
provided there. Any attempt to use these functions without guidance
can cause severe errors in your machine, including corruption of data.
You have been warned.
Constants
kNoProcess
kSystemProcess
kCurrentProcess
Special process IDs.
launchContinue
launchNoFileFlags
launchUseMinimum
launchDontSwitch
launchAllow24Bit
launchInhibitDaemon
Launch flags.
modeDeskAccessory
modeMultiLaunch
modeNeedSuspendResume
modeCanBackground
modeDoesActivateOnFGSwitch
modeOnlyBackground
modeGetFrontClicks
modeGetAppDiedMsg
mode32BitCompatible
modeHighLevelEventAware
modeLocalAndRemoteHLEvents
modeStationeryAware
modeUseTextEditServices
modeDisplayManagerAware
Mode flags in SIZE resource.
LaunchParam
This Perl hash maps onto the fields of a Launch Parameter Block.
The fields are:
launchFileFlags
launchControlFlags
launchAppSpec
launchAvailableSize
launchProcessSN
launchPreferredSize
launchMinimumSize
new LaunchParam [ARGUMENTS]
Returns LaunchParam.
$launch =
new LaunchParam(launchAppSpec =E<gt> "hd:apps:myapp", launchMinimumSize => 32000);
DESTROY LPB
ProcessInfo
This Perl hash allows access to the "ProcessInfo" structure.
The field names are:
processName
processNumber
processType
processSignature
processSize
processMode
processLocation
processLauncher
processLaunchDate
processActiveTime
processAppSpec
DESTROY PI
Functions
LaunchApplication LAUNCHPARAMS
The LaunchApplication function launches the application from the
specified file and returns the process serial number if the
application is successfully launched. Returns undef on failure.
LaunchDeskAccessory PFILESPEC, PDANAME
Mac OS only.
The LaunchDeskAccessory function searches the resource fork of the
file specified by the pFileSpec parameter for the desk accessory
with the 'DRVR' resource name specified in the pDAName parameter.
If the 'DRVR' resource name is found, LaunchDeskAccessory launches
the corresponding desk accessory. If the desk accessory is already
open, it is brought to the front. Returns zero on failure.
GetCurrentProcess
The GetCurrentProcess function returns the process serial number of
the process that is currently running, that is, the one currently
accessing the CPU. Return "undef" if an error was detected.
GetFrontProcess
The GetFrontProcess function returns the process serial number of
the process running in the foreground. Return "undef" if an error
was detected.
GetNextProcess PSN
Get information about the next process, if any, in the Process
ManagerO~s internal list of open processes. Return "undef" if an
error was detected.
GetProcessInformation PSN
The GetProcessInformation function returns, in a process
information record, information about the specified process. The
information returned in the info parameter includes the
applicationO~s name as it appears in the Application menu, the type
and signature of the application, the address of the application
partition, the number of bytes in the application partition, the
number of free bytes in the application heap, the application that
launched the application, the time at which the application was
launched, and the location of the application file. Return "undef"
if an error was detected.
SetFrontProcess PSN
The SetFrontProcess function schedules the specified process to
move to the foreground. The specified process moves to the
foreground after the current foreground process makes a subsequent
call to WaitNextEvent or EventAvail. Returns zero on failure.
WakeUpProcess PSN
The WakeUpProcess function makes a process suspended by
WaitNextEvent() eligible to receive CPU time. A process is
suspended when the value of the sleep parameter in the
WaitNextEvent() function is not 0 and no events for that process
are pending in the event queue. This process remains suspended
until the time specified in the sleep parameter expires or an event
becomes available for that process. You can use WakeUpProcess to
make the process eligible for execution before the time specified
in the sleep parameter expires. Returns zero on failure.
SameProcess PSN1, PSN2
The SameProcess function compares two process serial numbers and
determines whether they refer to the same process. Return "undef"
if an error was detected.
ExitToShell
This function is not implemented: ExitToShell() unsupported. Use
exit.
GetProcessPID(PSN)
Mac OS X only.
Get the UNIX process ID corresponding to a process serial number.
GetProcessForPID(PID)
Mac OS X only.
Get the process serial number corresponding to a UNIX process ID.
LSFindApplicationForInfo(creator, bundleID=NULL, name=NULL)
Mac OS X only.
Return the path to the application matching one or more of creator,
bundleID, and name. Pass undef or empty string for unused
parameters.
$path = LSFindApplicationForInfo("R*ch");
$path = LSFindApplicationForInfo(undef, "com.barebones.bbedit");
$path = LSFindApplicationForInfo(undef, undef, "BBEdit.app");
$path = LSFindApplicationForInfo("R*ch", "com.barebones.bbedit", "BBEdit.app");
AUTHOR
Written by Matthias Ulrich Neeracher <neeracher@mac.com>, documentation
by Bob Dalgleish <bob.dalgleish@sasknet.sk.ca>. Currently maintained
by Chris Nandor <pudge@pobox.com>.
perl v5.16.2 2013-08-25 Processes(3)