launchd/src/StartupItemContext.8

   1 .Dd July 7, 2002
   2 .Dt StartupItemContext 8
   3 .Os Darwin
   4 .Sh NAME
   5 .Nm StartupItemContext
   6 .\" The following lines are read in generating the apropos(man -k) database. Use only key
   7 .\" words here as the database is built based on the words here and in the .ND line.
   8 .\" Use .Nm macro to designate other names for the documented program.
   9 .Nd Execute a program in StartupItem context
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Ar program Op Ar arguments
  13 .Sh DESCRIPTION
  14 The
  15 .Nm
  16 utility launches the specified program in StartupItem bootstrap context.  Each Darwin
  17 and Mac OS X login creates a unique bootstrap subset context to contain login specific
  18 Mach port registrations with the bootstrap server.  All such registrations performed
  19 within the context of that subset are only visible to other processes within that
  20 context or subsequent subsets of it.  Therefore, a Mach port based service/daemon
  21 launched within a login context will not be visible to other such contexts.
  22 .Pp
  23 To override this, a root user can use the
  24 .Nm
  25 utility to launch the program within the same bootstrap context as all other
  26 StartupItems. All subsequent Mach port bootstrap registrations perfomed by the program
  27 will be visible system-wide.
  28 .Sh NOTES
  29 All bootstrap port lookups will also be resticted
  30 to the StartupItem context. The services provided on a per-login basis (clipboard,
  31 etc...) will not be available to the program.
  32 .Sh SEE ALSO
  33 .\" List links in ascending order by section, alphabetically within a section.
  34 .\" Please do not reference files that do not exist without filing a bug report
  35 .Xr SystemStarter 8