manpagez: man pages & more
man lsactivity(8)
Home | html | info | man

lsactivity(8)             BSD System Manager's Manual            lsactivity(8)


NAME

     lsactivity activity continuation companion -- Query and control the
     lsuseractivityd daemon, part of the LaunchServices framework


SYNOPSIS

     lsactivity [-] [-abcd] [-a path] [file] [file ...] arg0 arg2 ...


DESCRIPTION

     lsactivity controls and helps with testing of the UserActivity feature
     and frameworks.  The tool processes its arguments as command [ options...
     ] [ command [options...]]*

     A list of commands that deal with user activity items, and descriptions
     of each:

     create   [-title t] [-payload key=value] [-payloadData
              hexEncodedPayloadData] [-payloadFile path] [-options key=value]
              [-bundleID bundleString] [-type suggestedActionType]

              Creates a new user activity

              -title t
                   the title to give the activity

              -payload key=value
                   Add the value item to the payload with the key key

              -payloadData hexData
                   Uses NSKeyedUnarchiver to unarchive the given data

              -payloadFile path
                   read the payload dictionary from path

              -options key=value
                   Add the key,value pair to the options dictionary

              -type int
                   Sets the activity type to the given LSSuggestedActionType,
                   defaulting to LSSuggestedActionUserActivityType

              -url url
                   Sets the webpageURL for the item to url

     update   activityID [-title t] [-payload key=value] [-payloadFile path]
              [-bundleID bundleString] [--]

              Updates the user activity with any given items

              -title t
                   the title to give the activity

              -payload key=value
                   Add the value item to the payload with the key key

              -payloadData hexData
                   Uses NSKeyedUnarchiver to unarchive the given data

              -payloadFile path
                   read the payload dictionary from path

              -url url
                   Sets the webpageURL for the item to url
              activityID with the given new values.

     delete activityID [activityID ...] [--]
              Deletes each individual activity given as activityID

              If activityID is all then deletes all activities.

     list     lists the user activity items

     export activityID [activityID ...] [--]
              Exports each activity given by an activityID

     Commands which track, control, and affect the ranking of activities which
     the user could choose to resume on this device include:

     rank     [-all] [-watch] [-open] [-show] [-remove]

              -all     List all best apps, not just the top-ranked one.

              -watch   Display the live changes to the best application as
                       they happen.  Control-c to exit.

              -open    Attempt to open (as if selected by the user) each
                       received item

              -show    Fetch the activity from the remote device and display
                       the information, including the payload

              -remove  Remove the item from future consideration as a bestApp-
                       Suggestion until the item itself changes.

     reflect [-duration duration]

              -duration duration
                       The duration, in seconds, to reflect activities.

              Make whatever the most recently updated user activity is be
              'reflected' back to this device, as if it was received from
              anther device with exactly the identifier and payload as given.
              This is helpful when testing, because you can run this in a
              shell, and then resume the activity from lock screen or notifi-
              cation center, and it should send that activity back to the same
              application to see that it receives an activity correctly.

    Anywhere activityID is shown, it can be any of a full UUID, the prefix or
    suffix part of a UUID, or the title for an activity.


ADMINISTRATIVE CONTROL COMMANDS

     Commands that control the lsuseractivityd daemon.

     status   [-watch] [-interval duration]

              -watch   Run in full-screen mode, showing status every second

              -interval duration Update every duration seconds

              Get the current status of many aspects of the daemon.

     terminate
              Ask the daemon to terminate itself.

     reload
              Reload the daemon from its launchd plist (effectively killing
              the daemon)  Mac OS X only.

     restart
              Ase the daemon to restart.


BLUETOOTH ADVERTISING CONTROL

     Commands that directly change what this machine is advertising or display
     what is being received via the BTLE subsystem.

     advertiseBTLE [-identifier bundleidentifier] [-payload key=value]
              [-payloadFile path] [-options key=value] [-url url]

              -identifier bundleidentifier
                       Advertise the given bundle identifier

              -payload key=value
                       Add the key,value pair to the payload dictionary

              -payloadFile path
                       Read an entire payload from the file at path

              -options key=value
                       Add the key,value pair to the options dictionary

              -url url
                       Add url to the set of resourceURLs in the payload being
                       advertised

              Change the current BTLE advertisement to be the given bundleID,
              with the given payload. If no payload is specified then small
              random payload will be created so that the advertisement differs
              from any previous one.

     listenBTLE

              Listen for BTLE advertisements from other machines, and log a
              line each time a new item is seen.


MISCELLANEOUS

     Miscellaneous commands for different things.

     showpayload hex-string
              Decode the hex string as the data format the daemon stores each
              payload item and print out the resulting object(s).

     showbtlepayload hex-string
               Decode the hex string as the data format a user activity item
               is encoded into when it is sent via BTLE between two devices.

      idle [-duration secondsToRun] [-statusInterval secondsBetweenStatus]
                Run for up to secondsToRun seconds, printing the idle state of
                the system every file ... secondsBetweenStatus seconds.  Also
                print the status whenever the kIOUserActivityNotifyName
                notify() fires.



SEE ALSO

     lsuseractivityd(8)

Darwin                         November 8, 2014                         Darwin

OS X 10.10 - Generated Sat Nov 8 06:56:10 CST 2014
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.