Страницы справочника OS X

Эта страница руководства для  версии 10.9 Mac OS X

Читать страницы руководства

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)