xpc: update README with new events, markdown style fixes
This commit is contained in:
+31
-21
@@ -22,14 +22,15 @@ needed to run the built App.
|
||||
Before building the Xcode project, the strongSwan base tree must be built using
|
||||
a monolithic and static build. This can be achieved on OS X by using:
|
||||
|
||||
LDFLAGS="-all_load" \
|
||||
CFLAGS="-I/usr/include -DOPENSSL_NO_CMS -O2 -Wall -Wno-format -Wno-pointer-sign" \
|
||||
./configure --prefix=/opt/local --disable-defaults --enable-openssl \
|
||||
--enable-kernel-pfkey --enable-kernel-pfroute --enable-eap-mschapv2 \
|
||||
--enable-eap-identity --enable-monolithic --enable-nonce --enable-random \
|
||||
--enable-pkcs1 --enable-pem --enable-socket-default --enable-xauth-generic \
|
||||
--enable-keychain --enable-ikev1 --enable-ikev2 --enable-charon \
|
||||
--disable-shared --enable-static
|
||||
LDFLAGS="-all_load" \
|
||||
CFLAGS="-I/usr/include -DOPENSSL_NO_CMS -O2 -Wall -Wno-format -Wno-pointer-sign" \
|
||||
./configure --prefix=/opt/local --enable-monolithic \
|
||||
--disable-shared --enable-static --disable-defaults \
|
||||
--enable-openssl --enable-kernel-pfkey --enable-kernel-pfroute \
|
||||
--enable-eap-mschapv2 --enable-eap-identity --enable-nonce \
|
||||
--enable-random --enable-pkcs1 --enable-pem --enable-socket-default \
|
||||
--enable-xauth-generic --enable-keychain --enable-charon \
|
||||
--enable-ikev1 --enable-ikev2
|
||||
|
||||
followed by calling make (no need to make install).
|
||||
|
||||
@@ -47,8 +48,8 @@ Clients can connect to this service to control the daemon. All messages
|
||||
on all connections use the following string dictionary keys/values:
|
||||
|
||||
* _type_: XPC message type, currently either
|
||||
* _rpc_ for a remote procedure call, expects a response
|
||||
* _event_ for application specific event messages
|
||||
* _rpc_ for a remote procedure call, expects a response
|
||||
* _event_ for application specific event messages
|
||||
* _rpc_: defines the name of the RPC function to call (for _type_ = _rpc_)
|
||||
* _event_: defines a name for the event (for _type_ = _event_)
|
||||
|
||||
@@ -59,14 +60,14 @@ On the Mach service connection, the following RPC messages are currently
|
||||
defined:
|
||||
|
||||
* string version = get_version()
|
||||
* _version_: strongSwan version of charon-xpc
|
||||
* _version_: strongSwan version of charon-xpc
|
||||
* bool success = start_connection(string name, string host, string id,
|
||||
endpoint channel)
|
||||
* _success_: TRUE if initiation started successfully
|
||||
* _name_: connection name to initiate
|
||||
* _host_: server hostname (and identity)
|
||||
* _id_: client identity to use
|
||||
* _channel_: XPC endpoint for this connection
|
||||
endpoint channel)
|
||||
* _success_: TRUE if initiation started successfully
|
||||
* _name_: connection name to initiate
|
||||
* _host_: server hostname (and identity)
|
||||
* _id_: client identity to use
|
||||
* _channel_: XPC endpoint for this connection
|
||||
|
||||
The start_connection() RPC returns just after the initation of the call and
|
||||
does not wait for the connection to establish. Nonetheless does it have a
|
||||
@@ -80,9 +81,18 @@ On this channel, the following RPC calls are currently defined from charon-xpc
|
||||
to the App:
|
||||
|
||||
* string password = get_password(string username)
|
||||
* _password_: user password returned
|
||||
* _username_: username to query a password for
|
||||
* _password_: user password returned
|
||||
* _username_: username to query a password for
|
||||
|
||||
And the following from the App to charon-xpc:
|
||||
|
||||
* bool success = stop_connection()
|
||||
* _success_: TRUE if termination of connection initiated
|
||||
|
||||
The following events are currently defined from charon-xpc to the App:
|
||||
* _up_: connection has been established
|
||||
* _down_: connection has been closed or failed to establish
|
||||
|
||||
* up(): IKE_SA has been established
|
||||
* down(): IKE_SA has been closed or failed to establish
|
||||
* child_up(string local_ts, string remote_ts): CHILD_SA has been established
|
||||
* child_down(string local_ts, string remote_ts): CHILD_SA has been closed
|
||||
* log(string message): debug log message for this connection
|
||||
|
||||
Reference in New Issue
Block a user