{"id":1463,"date":"2009-02-02T15:40:07","date_gmt":"2009-02-02T18:40:07","guid":{"rendered":"http:\/\/brockerhoff.net\/bb\/viewtopic.php?p=2647"},"modified":"2010-05-08T11:34:08","modified_gmt":"2010-05-08T14:34:08","slug":"cocoa-musings-pt-3","status":"publish","type":"post","link":"https:\/\/brockerhoff.net\/blog\/2009\/02\/02\/cocoa-musings-pt-3\/","title":{"rendered":"Cocoa musings pt.3"},"content":{"rendered":"

It’s been a while since the last post, but I’ve finally gotten past the boring parts of the new Klicko<\/a> System Preference pane & background process. The latter is actually a per-user Launch Agent<\/a>. I’d used launchd<\/a> before in the last Quay<\/a> implementation, but didn’t fully understand what I was doing.<\/p>\n

Well, I still<\/em> can’t claim I fully understand all, but I’m definitely getting better at this. As soon as Klicko 1.2 is out and working (hm, maybe that should be the other way around?) I’ll back-port everything I learned to Quay.<\/p>\n

One important part of messing around with launchd agents is that you have to set everything up just so – permissions of the executable and<\/em> of its containing folders, as well as of the controlling plist if it’s a global agent; and you have to run launchctl<\/a> to load (register) the controlling plist with launchd. Only then, and if the conditions inside the plist are satisfied, launchd will run your agent for you.<\/p>\n

Uninstalling your agent, usually for putting an updated version in its place, must also be done carefully. You have to unload it if it’s loaded (even though it may not be running at the time) before swapping in the new executable and plist. Ideally, to avoid wasting time, there should be an easy way to test if your agent is properly loaded – the user might have unloaded it manually, or whatever. Unfortunately, the only “official” way to do so is to run launchctl again, passing in the “list” parameter, and parsing the output; not ideal.<\/p>\n

However, there’s a primitive API in place in <launch.h>, and in fact launchctl uses this API itself to communicate with launchd. Still, there’s no documentation about it; only some sample code. Also, there’s this recent reply on the launchd-dev mailing list<\/a>:<\/p>\n

Right now the <launch.h> API is only rated for
\ndaemons checking in with launchd (ala SampleD).
\nIt is not really designed for job management.
\nRather, we recommend that folks do their job
\nmanagement by fork\/exec of launchctl.
\n…
\nQuinn “The Eskimo!”<\/p><\/blockquote>\n

Still, I thought it would be interesting to use this API to check on the agent; after all, if something fails you’ll get an error back, and nothing will be messed up. So here’s the code for doing so:<\/p>\n

#include <launch.h>\r\n\r\nstatic id GetFromLaunchData(launch_data_t obj);\r\n\r\nstatic void Launch_data_iterate(launch_data_t obj, const char *key, void* dict) {\r\n\r\n\u00a0 \u00a0if (obj) {\r\n\u00a0 \u00a0\u00a0 \u00a0id value = GetFromLaunchData(obj);\r\n\u00a0 \u00a0\u00a0 \u00a0if(value) {\r\n\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0[(NSMutableDictionary*)dict setObject:value forKey:[NSString stringWithUTF8String:key]];\r\n\u00a0 \u00a0\u00a0 \u00a0}\r\n\u00a0 \u00a0}\r\n}\r\n\r\nstatic NSDictionary* GetFromLaunchDictionary(launch_data_t dict) {\r\n\u00a0 \u00a0NSMutableDictionary* result = NULL;\r\n\u00a0 \u00a0if (launch_data_get_type(dict)==LAUNCH_DATA_DICTIONARY) {\r\n\u00a0 \u00a0\u00a0 \u00a0result = [NSMutableDictionary dictionary];\r\n\u00a0 \u00a0\u00a0 \u00a0launch_data_dict_iterate(dict, Launch_data_iterate, result);\r\n\u00a0 \u00a0}\r\n\u00a0 \u00a0return result;\r\n}\r\n\r\nstatic NSArray* GetFromLaunchArray(launch_data_t arr) {\r\n\u00a0 \u00a0NSMutableArray* result = NULL;\u00a0 \u00a0\r\n\u00a0 \u00a0if (launch_data_get_type(arr)==LAUNCH_DATA_ARRAY) {\r\n\u00a0 \u00a0\u00a0 \u00a0size_t count = launch_data_array_get_count(arr);\r\n\u00a0 \u00a0\u00a0 \u00a0result = [NSMutableArray arrayWithCapacity:count];\r\n\u00a0 \u00a0\u00a0 \u00a0for (size_t i=0;i<count;i++) {\r\n\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0id obj = GetFromLaunchData(launch_data_array_get_index(arr, i));\r\n\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0if (obj) {\r\n\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0[result addObject:obj];\r\n\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0}\r\n\u00a0 \u00a0\u00a0 \u00a0}\r\n\u00a0 \u00a0}\r\n\u00a0 \u00a0return result;\r\n}\r\n\r\nstatic id GetFromLaunchData(launch_data_t obj) {\r\n\u00a0 \u00a0switch (launch_data_get_type(obj)) {\r\n\u00a0 \u00a0case LAUNCH_DATA_STRING:\r\n\u00a0 \u00a0\u00a0 \u00a0return [NSString stringWithUTF8String:launch_data_get_string(obj)];\r\n\u00a0 \u00a0case LAUNCH_DATA_INTEGER:\r\n\u00a0 \u00a0\u00a0 \u00a0return [NSNumber numberWithLongLong:launch_data_get_integer(obj)];\r\n\u00a0 \u00a0case LAUNCH_DATA_REAL:\r\n\u00a0 \u00a0\u00a0 \u00a0return [NSNumber numberWithDouble:launch_data_get_real(obj)];\r\n\u00a0 \u00a0case LAUNCH_DATA_BOOL:\r\n\u00a0 \u00a0\u00a0 \u00a0return [NSNumber numberWithBool:launch_data_get_bool(obj)?YES:NO];\r\n\u00a0 \u00a0case LAUNCH_DATA_ARRAY:\r\n\u00a0 \u00a0\u00a0 \u00a0return GetFromLaunchArray(obj);\r\n\u00a0 \u00a0case LAUNCH_DATA_DICTIONARY:\r\n\u00a0 \u00a0\u00a0 \u00a0return GetFromLaunchDictionary(obj);\r\n\u00a0 \u00a0case LAUNCH_DATA_FD:\r\n\u00a0 \u00a0\u00a0 \u00a0return [NSNumber numberWithInt:launch_data_get_fd(obj)];\r\n\u00a0 \u00a0case LAUNCH_DATA_MACHPORT:\r\n\u00a0 \u00a0\u00a0 \u00a0return [NSNumber numberWithInt:launch_data_get_machport(obj)];\r\n\u00a0 \u00a0default:\r\n\u00a0 \u00a0\u00a0 \u00a0break;\r\n\u00a0 \u00a0}\r\n\u00a0 \u00a0return nil;\r\n}\r\n\r\nstatic NSDictionary* GetFromJobLabel(NSString* job) {\r\n\u00a0 \u00a0NSDictionary* result = nil;\r\n\u00a0 \u00a0launch_data_t msg = launch_data_alloc(LAUNCH_DATA_DICTIONARY);\r\n\u00a0 \u00a0if (msg&&launch_data_dict_insert(msg, launch_data_new_string([job fileSystemRepresentation]), LAUNCH_KEY_GETJOB)) {\r\n\u00a0 \u00a0\u00a0 \u00a0launch_data_t response = launch_msg(msg);\r\n\u00a0 \u00a0\u00a0 \u00a0launch_data_free(msg);\r\n\u00a0 \u00a0\u00a0 \u00a0if (response&&(launch_data_get_type(response)==LAUNCH_DATA_DICTIONARY)) {\r\n\u00a0 \u00a0\u00a0 \u00a0\u00a0 \u00a0result = GetFromLaunchDictionary(response);\r\n\u00a0 \u00a0\u00a0 \u00a0}\r\n\u00a0 \u00a0\u00a0 \u00a0launch_data_free(response);\r\n\u00a0 \u00a0}\r\n\u00a0 \u00a0return result;\r\n}<\/code><\/pre>\n
To use it, just call the last function like this:<\/p>\n
\u00a0 \u00a0NSDictionary* dictionary = GetFromJobLabel(@\"com.yourcompany.agentlabel\");<\/code><\/pre>\n
and examine the dictionary. If it’s nil, some error happened, or your agent isn’t loaded into launchd.<\/p>\n
If you do get a dictionary back, it will be autoreleased, and the “Label” key’s object  should be equal to the string you passed in. There are two more keys that might be interesting to check: “PID” will contain your agent’s pid if it’s running, and will be missing if it’s not; and “LastExitStatus” will show you what your agent’s main() returned on its last run.<\/p>\n
Note that most of the code above is actually based on the launchd<\/a> source, converted to use Foundation objects instead of CFTypes.<\/p>\n","protected":false},"excerpt":{"rendered":"
It’s been a while since the last post, but I’ve finally gotten past the boring parts of the new Klicko System Preference pane & background process. The latter is actually a per-user Launch Agent. I’d used launchd before in the last Quay implementation, but didn’t fully understand what I was doing. Well, I still can’t […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[4,19],"tags":[26,28,27],"class_list":["post-1463","post","type-post","status-publish","format-standard","hentry","category-dev","category-software","tag-cocoa","tag-klicko","tag-quay"],"featured_image_src":null,"author_info":{"display_name":"Rainer Brockerhoff","author_link":"https:\/\/brockerhoff.net\/blog\/author\/rbrockerhoff\/"},"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p1q3Zc-nB","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/posts\/1463","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/comments?post=1463"}],"version-history":[{"count":0,"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/posts\/1463\/revisions"}],"wp:attachment":[{"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/media?parent=1463"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/categories?post=1463"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/brockerhoff.net\/blog\/wp-json\/wp\/v2\/tags?post=1463"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}