[launchd-dev] Confused about sockets - please help!

[dreamcat four]

Hi,
I'm writing a library API to manipulate launchd plists (from Ruby).
But after reading and re-reading the man page, still very uncertain
whether theres any difference between:

Sockets <dictionary of dictionaries... OR dictionary of array of
dictionaries...>

Are all of these different possible structures interchangeable? (ie
meaning the same thing to launchd program?)



For example:

<key>Sockets</key>
<dict>
	<key>Listeners</key>
	<array>
		<dict>
			<key>SockNodeName</key>
			<string>::1</string>
			<key>SockServiceName</key>
			<string>ipp</string>
		</dict>
		<dict>
			<key>SockNodeName</key>
			<string>127.0.0.1</string>
			<key>SockServiceName</key>
			<string>ipp</string>
		</dict>
		<dict>
			<key>SockPathMode</key>
			<integer>49663</integer>
			<key>SockPathName</key>
			<string>/private/var/run/cupsd</string>
		</dict>
	</array>
</dict>


or


<key>Sockets</key>
<dict>
	<key>listener1</key>
	<dict>
		<key>SockNodeName</key>
		<string>::1</string>
		<key>SockServiceName</key>
		<string>ipp</string>
	</dict>
	<key>listener2</key>
	<dict>
		<key>SockNodeName</key>
		<string>127.0.0.1</string>
		<key>SockServiceName</key>
		<string>ipp</string>
	</dict>
	<key>listener3</key>
	<dict>
		<key>SockPathMode</key>
		<integer>49663</integer>
		<key>SockPathName</key>
		<string>/private/var/run/cupsd</string>
	</dict>
</dict>


or

<key>Sockets</key>
<dict>
  <key>listener1</key>
	<array>
		<dict>
			<key>SockNodeName</key>
			<string>::1</string>
			<key>SockServiceName</key>
			<string>ipp</string>
		</dict>
	</array>
	<key>listener2</key>
	<array>
		<dict>
			<key>SockNodeName</key>
			<string>127.0.0.1</string>
			<key>SockServiceName</key>
			<string>ipp</string>
		</dict>
	</array>
	<key>listener3</key>
	<array>
		<dict>
			<key>SockPathMode</key>
			<integer>49663</integer>
			<key>SockPathName</key>
			<string>/private/var/run/cupsd</string>
		</dict>
	</array>
</dict>




I'd really love to get an answer here, as its the last thing needed to
complete the API interface.

Best regards

dreamcat4
dreamcat4 at gmail.com