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