From 26914f95a7f8bd868d8808f00fd90f90926f690a Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Tue, 13 Nov 2007 19:34:40 +0100 Subject: Move to a suitable place. --- howtos.mdwn | 3 +- hurd/translator.mdwn | 2 + hurd/translator/writing/example.mdwn | 301 +++++++++++++++++++++++++++++++++++ hurdtranslatorexample.mdwn | 301 ----------------------------------- 4 files changed, 305 insertions(+), 302 deletions(-) create mode 100644 hurd/translator/writing/example.mdwn delete mode 100644 hurdtranslatorexample.mdwn diff --git a/howtos.mdwn b/howtos.mdwn index 8cd3ed2c..7d893c68 100644 --- a/howtos.mdwn +++ b/howtos.mdwn @@ -17,7 +17,8 @@ is included in the section entitled * Setting up translators -- [[some_examples|hurd/translator/examples]] * [[QemuFileSharingWithHost]] File sharing between GNU on Qemu and the Host OS * [[Setupcvsfs]]Setting up cvsfs from HurdExtras - * [[HurdTranslatorExample]] Hurd translator example + * [[hurd/translator/writing/Example]] about how to write a simple Hurd + translator * [[hurd/libhello_example]] -- Hurd library example ## Compilation diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn index 63812e0d..202f6ff1 100644 --- a/hurd/translator.mdwn +++ b/hurd/translator.mdwn @@ -31,6 +31,8 @@ To learn how to write a translator, read the code! It is well documented, in particular, the header files. The [[Hurd_Hacking_Guide]] also has a tutorial. +Also there is an [[writing/example]] about how to write a simple translator. + # Existing Translators diff --git a/hurd/translator/writing/example.mdwn b/hurd/translator/writing/example.mdwn new file mode 100644 index 00000000..83ac7da1 --- /dev/null +++ b/hurd/translator/writing/example.mdwn @@ -0,0 +1,301 @@ +[[meta copyright="Copyright © 2007 Free Software Foundation, Inc."]] +[[meta license="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU_Free_Documentation_License|/fdl]]."]] + +## Data User-Server Translator Example + +The code examples were written by Anand Babu. + +We have a data.h header file, a data.defs file, a data-user.c, data-server.c +sources files and a Makefile. + +data.h: +------- + + #ifndef _data_user_ + #define _data_user_ + + /* Module data */ + + #include + #include + #include + + #include + #include + #include + #include + #include + #include + #include + #include + #include + #include + + /* Routine data_set_value */ + #ifdef mig_external + mig_external + #else + extern + #endif + kern_return_t S_data_set_value + #if defined(LINTLIBRARY) + (data_port, value) + mach_port_t data_port; + int value; + { return S_data_set_value(data_port, value); } + #else + ( + mach_port_t data_port, + int value + ); + #endif + + /* Routine data_get_value */ + #ifdef mig_external + mig_external + #else + extern + #endif + kern_return_t S_data_get_value + #if defined(LINTLIBRARY) + (data_port, value) + mach_port_t data_port; + int *value; + { return S_data_get_value(data_port, value); } + #else + ( + mach_port_t data_port, + int *value + ); + #endif + + #endif /* not defined(_data_user_) */ + +data.defs: +---------- + + /* Definitions for data interface + + This file is part of the GNU Hurd. + + The GNU Hurd is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2, or (at your option) + any later version. + + The GNU Hurd is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with the GNU Hurd; see the file COPYING. If not, write to + the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ + + subsystem data 45000; + + #include + + #ifdef STACK_IMPORTS + STACK_IMPORTS + #endif + + /* intr-rpc.defs defines the INTR_INTERFACE macro to make the generated RPC + stubs send-interruptible, and to prefix them with `hurd_intr_rpc_'. */ + INTR_INTERFACE + + /* set integer value to data */ + routine data_set_value ( + data_port: mach_port_t; + value: int); + + /* get integer value from data */ + routine data_get_value ( + data_port: mach_port_t; + out value: int); + +data-user.c: +------------ + + #include + #include + #include + #include "data.h" + + #ifndef _GNU_SOURCE + #define _GNU_SOURCE + #endif + + int + main(int argc, char *argv[]) + { + int value=0; + mach_port_t data_server_port; + + data_server_port = file_name_lookup ("/tmp/trans", 0, 0); + printf ("data_server_port [%u]\n", data_server_port); + S_data_set_value (data_server_port, 99); + S_data_get_value (data_server_port, &value); + printf ("data->get_value: [%d]\n", value); + + return 0; + } + +data-server.c: +-------------- + + #ifndef _GNU_SOURCE + #define _GNU_SOURCE + #endif + + #include + #include + #include + #include + #include + + #include + #include + #include + + #include "data.h" + + extern boolean_t S_data_server + (mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP); + + int trivfs_fstype = FSTYPE_MISC; + int trivfs_fsid = 0; + int trivfs_support_read = 0; + int trivfs_support_write = 0; + int trivfs_support_exec = 0; + int trivfs_allow_open = 0x00; + int trivfs_protid_nportclasses = 0; + int trivfs_cntl_nportclasses = 0; + + int data_value; + + int demuxer (mach_msg_header_t *inp, mach_msg_header_t *outp) + { + return (S_data_server(inp,outp)||trivfs_demuxer(inp,outp)); + } + + void trivfs_modify_stat (struct trivfs_protid *cred, io_statbuf_t *st) + { + } + error_t trivfs_goaway (struct trivfs_control *fsys, int flags) + { + exit (0); + } + + kern_return_t S_data_set_value (mach_port_t data_port, int value) + { + data_value = value; + return 0; + } + + kern_return_t S_data_get_value (mach_port_t data_port, int *value) + { + *value = data_value; + return 0; + } + + int + main(int argc, char *argv[]) + { + int err; + mach_port_t bootstrap; + struct trivfs_control *fsys; + + if (argc > 1) + { + fprintf(stderr, "Usage: settrans [opts] node %s\n", program_invocation_name); + exit (1); + } + + task_get_bootstrap_port (mach_task_self (), &bootstrap); + if (bootstrap == MACH_PORT_NULL) + error(2, 0, "Must be started as a translator"); + + /* Reply to our parent */ + err = trivfs_startup (bootstrap, 0, 0, 0, 0, 0,&fsys); + mach_port_deallocate (mach_task_self (), bootstrap); + if (err) { + return (0); + } + + ports_manage_port_operations_one_thread (fsys->pi.bucket, demuxer, 0); + + return 0; + } + +Makefile: +--------- + + CC = gcc + MIG = mig + CFLAGS = -Wall -g -D_GNU_SOURCE + LDFLAGS = -lthreads -lports -ltrivfs -lfshelp -lshouldbeinlibc + INCLUDES = -I. + LCHDRS = + MIGCOMSFLAGS = -prefix S_ + OBJS = $(SRCS:.c=.o) + TAGS = etags.emacs21 + + all: data-server data-user + tags: + $(TAGS) $(SRCS) $(LCHDRS) + + stubs: data.defs + $(MIG) $(MIGCOMSFLAGS) -server dataServer.c -user dataUser.c $^ + data-server: data-server.c dataServer.c + $(CC) $^ $(CFLAGS) $(INCLUDES) $(LDFLAGS) -o $@ + data-user: data-user.c dataUser.c + $(CC) $^ $(CFLAGS) $(INCLUDES) -o $@ + clean: + rm -f *.o data-server data-user + + start: data-server data-user + settrans -ac /tmp/trans data-server + ps -x | grep data-server + end: + settrans -fg /tmp/trans + +Building +-------- + +Do + + make stubs + +to create the dataUser.c and dataServer.c files generated by mig. Create the +executables using: + + make all + +Testing +------- + +Start the data-server translator using: + + settrans -ac /tmp/trans data-server + +You can check if it is running using + + ps -x | grep data-server + +Run the data-user executable to get the resultant output. + +You can remove the translator using: + + settrans -fg /tmp/trans + +To remove the built files use: + + make clean + +Happy Hacking! diff --git a/hurdtranslatorexample.mdwn b/hurdtranslatorexample.mdwn deleted file mode 100644 index 83ac7da1..00000000 --- a/hurdtranslatorexample.mdwn +++ /dev/null @@ -1,301 +0,0 @@ -[[meta copyright="Copyright © 2007 Free Software Foundation, Inc."]] -[[meta license="Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, Version 1.2 or -any later version published by the Free Software Foundation; with no Invariant -Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license -is included in the section entitled -[[GNU_Free_Documentation_License|/fdl]]."]] - -## Data User-Server Translator Example - -The code examples were written by Anand Babu. - -We have a data.h header file, a data.defs file, a data-user.c, data-server.c -sources files and a Makefile. - -data.h: -------- - - #ifndef _data_user_ - #define _data_user_ - - /* Module data */ - - #include - #include - #include - - #include - #include - #include - #include - #include - #include - #include - #include - #include - #include - - /* Routine data_set_value */ - #ifdef mig_external - mig_external - #else - extern - #endif - kern_return_t S_data_set_value - #if defined(LINTLIBRARY) - (data_port, value) - mach_port_t data_port; - int value; - { return S_data_set_value(data_port, value); } - #else - ( - mach_port_t data_port, - int value - ); - #endif - - /* Routine data_get_value */ - #ifdef mig_external - mig_external - #else - extern - #endif - kern_return_t S_data_get_value - #if defined(LINTLIBRARY) - (data_port, value) - mach_port_t data_port; - int *value; - { return S_data_get_value(data_port, value); } - #else - ( - mach_port_t data_port, - int *value - ); - #endif - - #endif /* not defined(_data_user_) */ - -data.defs: ----------- - - /* Definitions for data interface - - This file is part of the GNU Hurd. - - The GNU Hurd is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2, or (at your option) - any later version. - - The GNU Hurd is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with the GNU Hurd; see the file COPYING. If not, write to - the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ - - subsystem data 45000; - - #include - - #ifdef STACK_IMPORTS - STACK_IMPORTS - #endif - - /* intr-rpc.defs defines the INTR_INTERFACE macro to make the generated RPC - stubs send-interruptible, and to prefix them with `hurd_intr_rpc_'. */ - INTR_INTERFACE - - /* set integer value to data */ - routine data_set_value ( - data_port: mach_port_t; - value: int); - - /* get integer value from data */ - routine data_get_value ( - data_port: mach_port_t; - out value: int); - -data-user.c: ------------- - - #include - #include - #include - #include "data.h" - - #ifndef _GNU_SOURCE - #define _GNU_SOURCE - #endif - - int - main(int argc, char *argv[]) - { - int value=0; - mach_port_t data_server_port; - - data_server_port = file_name_lookup ("/tmp/trans", 0, 0); - printf ("data_server_port [%u]\n", data_server_port); - S_data_set_value (data_server_port, 99); - S_data_get_value (data_server_port, &value); - printf ("data->get_value: [%d]\n", value); - - return 0; - } - -data-server.c: --------------- - - #ifndef _GNU_SOURCE - #define _GNU_SOURCE - #endif - - #include - #include - #include - #include - #include - - #include - #include - #include - - #include "data.h" - - extern boolean_t S_data_server - (mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP); - - int trivfs_fstype = FSTYPE_MISC; - int trivfs_fsid = 0; - int trivfs_support_read = 0; - int trivfs_support_write = 0; - int trivfs_support_exec = 0; - int trivfs_allow_open = 0x00; - int trivfs_protid_nportclasses = 0; - int trivfs_cntl_nportclasses = 0; - - int data_value; - - int demuxer (mach_msg_header_t *inp, mach_msg_header_t *outp) - { - return (S_data_server(inp,outp)||trivfs_demuxer(inp,outp)); - } - - void trivfs_modify_stat (struct trivfs_protid *cred, io_statbuf_t *st) - { - } - error_t trivfs_goaway (struct trivfs_control *fsys, int flags) - { - exit (0); - } - - kern_return_t S_data_set_value (mach_port_t data_port, int value) - { - data_value = value; - return 0; - } - - kern_return_t S_data_get_value (mach_port_t data_port, int *value) - { - *value = data_value; - return 0; - } - - int - main(int argc, char *argv[]) - { - int err; - mach_port_t bootstrap; - struct trivfs_control *fsys; - - if (argc > 1) - { - fprintf(stderr, "Usage: settrans [opts] node %s\n", program_invocation_name); - exit (1); - } - - task_get_bootstrap_port (mach_task_self (), &bootstrap); - if (bootstrap == MACH_PORT_NULL) - error(2, 0, "Must be started as a translator"); - - /* Reply to our parent */ - err = trivfs_startup (bootstrap, 0, 0, 0, 0, 0,&fsys); - mach_port_deallocate (mach_task_self (), bootstrap); - if (err) { - return (0); - } - - ports_manage_port_operations_one_thread (fsys->pi.bucket, demuxer, 0); - - return 0; - } - -Makefile: ---------- - - CC = gcc - MIG = mig - CFLAGS = -Wall -g -D_GNU_SOURCE - LDFLAGS = -lthreads -lports -ltrivfs -lfshelp -lshouldbeinlibc - INCLUDES = -I. - LCHDRS = - MIGCOMSFLAGS = -prefix S_ - OBJS = $(SRCS:.c=.o) - TAGS = etags.emacs21 - - all: data-server data-user - tags: - $(TAGS) $(SRCS) $(LCHDRS) - - stubs: data.defs - $(MIG) $(MIGCOMSFLAGS) -server dataServer.c -user dataUser.c $^ - data-server: data-server.c dataServer.c - $(CC) $^ $(CFLAGS) $(INCLUDES) $(LDFLAGS) -o $@ - data-user: data-user.c dataUser.c - $(CC) $^ $(CFLAGS) $(INCLUDES) -o $@ - clean: - rm -f *.o data-server data-user - - start: data-server data-user - settrans -ac /tmp/trans data-server - ps -x | grep data-server - end: - settrans -fg /tmp/trans - -Building --------- - -Do - - make stubs - -to create the dataUser.c and dataServer.c files generated by mig. Create the -executables using: - - make all - -Testing -------- - -Start the data-server translator using: - - settrans -ac /tmp/trans data-server - -You can check if it is running using - - ps -x | grep data-server - -Run the data-user executable to get the resultant output. - -You can remove the translator using: - - settrans -fg /tmp/trans - -To remove the built files use: - - make clean - -Happy Hacking! -- cgit v1.3.1