Manual browser: AppBroker(1)

Name

AppBroker — Broker for the App message-passing specification

Synopsis

AppBroker [ -c | -s ] [-o output] filename

Description

AppBroker is a broker for the App message-passing protocol. It translates an interface definition file into a C header file, suitable as a reference while implementing an AppServer.

Options

AppBroker expects a specification file to be specified on the command line. The following options are available:

-c: Generate a file suitable for a client.
-s: Generate a file suitable for a server. This is the default behavior.
-o: Output file.

Example

The following interface definition file:

service=VFS

[call::chmod]
ret=INT32
arg1=STRING,pathname
arg2=UINT32,mode

will likely be translated as follows for a server:

/* $Id$ */



#ifndef VFS_VFS_H
# define VFS_VFS_H

# include <stdint.h>
# include <System/App.h>


/* types */
typedef Buffer * BUFFER;
typedef double * DOUBLE;
typedef float * FLOAT;
typedef int16_t INT16;
typedef int32_t INT32;
typedef uint16_t UINT16;
typedef uint32_t UINT32;
typedef String const * STRING;
typedef void VOID;

typedef BUFFER BUFFER_IN;

typedef DOUBLE DOUBLE_IN;

typedef FLOAT FLOAT_IN;
typedef INT32 INT32_IN;
typedef UINT32 UINT32_IN;
typedef STRING STRING_IN;

typedef Buffer * BUFFER_OUT;
typedef int32_t * INT32_OUT;
typedef uint32_t * UINT32_OUT;
typedef String ** STRING_OUT;

typedef Buffer * BUFFER_INOUT;
typedef int32_t * INT32_INOUT;
typedef uint32_t * UINT32_INOUT;
typedef String ** STRING_INOUT;


/* calls */
INT32 VFS_chmod(App * app, AppServerClient * client, STRING pathname, UINT32 mode);

#endif /* !VFS_VFS_H */

Bugs

Issues can be listed and reported at http://www.defora.org/os/project/bug_list/3564/libApp.