public inbox for ltp@lists.linux.it
 help / color / mirror / Atom feed
From: Subrata Modak <subrata@linux.vnet.ibm.com>
To: Manas Kumar Nayak <maknayak@in.ibm.com>
Cc: LTP List <ltp-list@lists.sourceforge.net>
Subject: Re: [LTP] [PATCH 05/13] Add/Port mq_notify01 test for mq_notify()	syscall
Date: Fri, 29 May 2009 18:26:16 +0530	[thread overview]
Message-ID: <1243601776.5188.47.camel@subratamodak.linux.ibm.com> (raw)
In-Reply-To: <20090527100907.18638.61338.sendpatchset@subratamodak.linux.ibm.com>

On Wed, 2009-05-27 at 15:39 +0530, Manas Kumar Nayak wrote: 
> Signed-off-by: Manas Kumar Nayak <maknayak@in.ibm.com>

Thanks.

Regards--
Subrata

> To: LTP List <ltp-list@lists.sourceforge.net>
> Cc: Subrata Modak <subrata@linux.vnet.ibm.com>
> Cc: Masatake YAMATO <yamato@redhat.com>
> ---
> 
> --- ltp-intermediate-20090521.orig/testcases/kernel/syscalls/mq_notify/Makefile	1970-01-01 05:30:00.000000000 +0530
> +++ ltp-intermediate-20090521/testcases/kernel/syscalls/mq_notify/Makefile	2009-05-23 11:08:05.000000000 +0530
> @@ -0,0 +1,31 @@
> +#
> +#  Copyright (c) International Business Machines  Corp., 2009
> +#
> +#  This program 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 of the License, or
> +#  (at your option) any later version.
> +#
> +#  This program 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 this program;  if not, write to the Free Software
> +#  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
> +#
> +
> +CFLAGS += -I../../../../include -Wall -O2 -D_POSIX_C_SOURCE=$(shell getconf _POSIX_MESSAGE_PASSING)L
> +LDLIBS += -L../../../../lib -lltp -lrt
> +
> +SRCS    = $(wildcard *.c)
> +TARGETS = $(patsubst %.c,%,$(SRCS))
> +
> +all: $(TARGETS)
> +
> +install:
> +	@set -e; for i in $(TARGETS); do ln -f $$i ../../../bin/$$i ; done
> +
> +clean:
> +	rm -f $(TARGETS)
> --- ltp-intermediate-20090521.orig/testcases/kernel/syscalls/mq_notify/mq_notify01.c	1970-01-01 05:30:00.000000000 +0530
> +++ ltp-intermediate-20090521/testcases/kernel/syscalls/mq_notify/mq_notify01.c	2009-05-27 12:49:33.000000000 +0530
> @@ -0,0 +1,477 @@
> +/******************************************************************************/
> +/* Copyright (c) Crackerjack Project., 2007-2008 ,Hitachi, Ltd                */
> +/*          Author(s): Takahiro Yasui <takahiro.yasui.mp@hitachi.com>,	      */
> +/*		       Yumiko Sugita <yumiko.sugita.yf@hitachi.com>, 	      */
> +/*		       Satoshi Fujiwara <sa-fuji@sdl.hitachi.co.jp>	      */
> +/*                                                                  	      */
> +/* This program 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 of the License, or          */
> +/* (at your option) any later version.                                        */
> +/*                                                                            */
> +/* This program 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 this program;  if not, write to the Free Software               */
> +/* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA    */
> +/*                                                                            */
> +/******************************************************************************/
> +/******************************************************************************/
> +/*                                                                            */
> +/* File:        mq_notify01.c                                                 */
> +/*                                                                            */
> +/* Description: This tests the mq_notify() syscall                            */
> +/*									      */
> +/* 									      */
> +/*									      */
> +/*									      */
> +/*									      */
> +/*                                                                            */
> +/* Usage:  <for command-line>                                                 */
> +/* mq_notify01 [-c n] [-e][-i n] [-I x] [-p x] [-t]                           */
> +/*      where,  -c n : Run n copies concurrently.                             */
> +/*              -e   : Turn on errno logging.                                 */
> +/*              -i n : Execute test n times.                                  */
> +/*              -I x : Execute test for x seconds.                            */
> +/*              -P x : Pause for x seconds between iterations.                */
> +/*              -t   : Turn on syscall timing.                                */
> +/*                                                                            */
> +/* Total Tests: 1                                                             */
> +/*                                                                            */
> +/* Test Name:   mq_notify01                                                   */
> +/* History:     Porting from Crackerjack to LTP is done by                    */
> +/*              Manas Kumar Nayak maknayak@in.ibm.com>                        */
> +/******************************************************************************/
> +#include <sys/syscall.h>
> +#include <sys/types.h>
> +#include <sys/stat.h>
> +#include <sys/uio.h>
> +#include <getopt.h>
> +#include <stdlib.h>
> +#include <errno.h>
> +#include <stdio.h>
> +#include <unistd.h>
> +#include <string.h>
> +#include <mqueue.h>
> +#include <signal.h>
> +#include <limits.h>
> +
> +#include "../utils/include_j_h.h"
> +
> +/* Harness Specific Include Files. */
> +#include "test.h"
> +#include "usctest.h"
> +#include "linux_syscall_numbers.h"
> +
> +/* Extern Global Variables */
> +extern int Tst_count;           /* counter for tst_xxx routines.         */
> +extern char *TESTDIR;           /* temporary dir created by tst_tmpdir() */
> +
> +/* Global Variables */
> +char *TCID = "mq_notify01";  /* Test program identifier.*/
> +int  testno;
> +int  TST_TOTAL = 1;                   /* total number of tests in this file.   */
> +
> +/* Extern Global Functions */
> +/******************************************************************************/
> +/*                                                                            */
> +/* Function:    cleanup                                                       */
> +/*                                                                            */
> +/* Description: Performs all one time clean up for this test on successful    */
> +/*              completion,  premature exit or  failure. Closes all temporary */
> +/*              files, removes all temporary directories exits the test with  */
> +/*              appropriate return code by calling tst_exit() function.       */
> +/*                                                                            */
> +/* Input:       None.                                                         */
> +/*                                                                            */
> +/* Output:      None.                                                         */
> +/*                                                                            */
> +/* Return:      On failure - Exits calling tst_exit(). Non '0' return code.   */
> +/*              On success - Exits calling tst_exit(). With '0' return code.  */
> +/*                                                                            */
> +/******************************************************************************/
> +extern void cleanup() {
> +        /* Remove tmp dir and all files in it */
> +        TEST_CLEANUP;
> +        tst_rmdir();
> +
> +        /* Exit with appropriate return code. */
> +        tst_exit();
> +}
> +
> +/* Local  Functions */
> +/******************************************************************************/
> +/*                                                                            */
> +/* Function:    setup                                                         */
> +/*                                                                            */
> +/* Description: Performs all one time setup for this test. This function is   */
> +/*              typically used to capture signals, create temporary dirs      */
> +/*              and temporary files that may be used in the course of this    */
> +/*              test.                                                         */
> +/*                                                                            */
> +/* Input:       None.                                                         */
> +/*                                                                            */
> +/* Output:      None.                                                         */
> +/*                                                                            */
> +/* Return:      On failure - Exits by calling cleanup().                      */
> +/*              On success - returns 0.                                       */
> +/*                                                                            */
> +/******************************************************************************/
> +void setup() {
> +        /* Capture signals if any */
> +        /* Create temporary directories */
> +        TEST_PAUSE;
> +        tst_tmpdir();
> +}
> +
> +
> +/*
> + * Macros
> + */
> +#define SYSCALL_NAME    "mq_notify"
> +
> +
> +/*
> + * Global variables
> + */
> +static int opt_debug;
> +static char *progname;
> +static int notified;
> +static int cmp_ok;
> +
> +
> +enum test_type {
> +		NORMAL,
> +		FD_NONE,
> +	        FD_NOT_EXIST,
> +        	FD_FILE,
> +	        ALREADY_REGISTERED,
> +};
> +
> +
> +/*
> + * Data Structure
> + */
> +struct test_case {
> +        int notify;
> +	int ttype;
> +        int ret;
> +        int err;
> +};
> +
> +#define MAX_MSGSIZE     8192
> +#define MSG_SIZE        16
> +#define USER_DATA       0x12345678
> +
> +
> +/* Test cases
> + *
> + *   test status of errors on man page
> + *
> + *   EBADF              v (not a valid descriptor)
> + *   EBUSY              v (process is already registered for notification)
> +*/
> +
> +
> +static struct test_case tcase[] = {
> +	{ // case00
> +                .ttype          = NORMAL,
> +                .notify         = SIGEV_NONE,
> +                .ret            = 0,
> +                .err            = 0,
> +        },
> +        { // case01
> +                .ttype          = NORMAL,
> +                .notify         = SIGEV_SIGNAL,
> +                .ret            = 0,
> +                .err            = 0,
> +        },
> +        { // case02
> +                .ttype          = NORMAL,
> +                .notify         = SIGEV_THREAD,
> +                .ret            = 0,
> +                .err            = 0,
> +        },
> +        { // case03
> +                .ttype          = FD_NONE,
> +                .notify         = SIGEV_NONE,
> +                .ret            = -1,
> +                .err            = EBADF,
> +        },
> +        { // case04
> +                .ttype          = FD_NOT_EXIST,
> +                .notify         = SIGEV_NONE,
> +                .ret            = -1,
> +                .err            = EBADF,
> +        },
> +        { // case05
> +                .ttype          = FD_FILE,
> +                .notify         = SIGEV_NONE,
> +                .ret            = -1,
> +                .err            = EBADF,
> +        },
> +        { // case06
> +                .ttype          = ALREADY_REGISTERED,
> +                .notify         = SIGEV_NONE,
> +                .ret            = -1,
> +                .err            = EBUSY,
> +        },
> +};
> +
> +
> +static void sigfunc(int signo, siginfo_t *info, void *data)
> +{
> +        if (opt_debug) {
> +                tst_resm(TINFO,"si_code  E:%d,\tR:%d", info->si_code, SI_MESGQ);
> +                tst_resm(TINFO,"si_signo E:%d,\tR:%d", info->si_signo, SIGUSR1);
> +                tst_resm(TINFO,"si_value E:0x%x,\tR:0x%x", info->si_value.sival_int,USER_DATA);
> +                tst_resm(TINFO,"si_pid   E:%d,\tR:%d", info->si_pid, getpid());
> +                tst_resm(TINFO,"si_uid   E:%d,\tR:%d", info->si_uid, getuid());
> +        }
> +        cmp_ok = info->si_code == SI_MESGQ &&
> +                 info->si_signo == SIGUSR1 &&
> +                 info->si_value.sival_int == USER_DATA &&
> +                 info->si_pid == getpid() &&
> +                 info->si_uid == getuid();
> +        notified = 1;
> +}
> +
> +static void tfunc(union sigval sv)
> +{
> +        cmp_ok = sv.sival_int == USER_DATA;
> +        notified = 1;
> +}
> +
> +/*
> + * do_test()
> + *
> + *   Input  : TestCase Data
> + *   Return : RESULT_OK(0), RESULT_NG(1)
> + *
> + */
> +
> +static int do_test(struct test_case *tc)
> +{
> +        int sys_ret;
> +        int sys_errno;
> +        int result = RESULT_OK;
> +        int rc, i, fd = -1;
> +        struct sigevent ev;
> +        struct sigaction sigact;
> +        char smsg[MAX_MSGSIZE];
> +
> +        notified = cmp_ok = 1;
> +
> +        /*
> +         * When test ended with SIGTERM etc, mq discriptor is left remains.
> +         * So we delete it first.
> +         */
> +        TEST(mq_unlink(QUEUE_NAME));
> +
> +        switch (tc->ttype) {
> +        case FD_NOT_EXIST:
> +                fd = INT_MAX - 1;
> +                /* fallthrough */
> +	case FD_NONE:
> +                break;
> +        case FD_FILE:
> +                TEST(fd = open("/", O_RDONLY));
> +                if (TEST_RETURN < 0) {
> +                        tst_resm(TFAIL,"can't open \"/\".");
> +                        result = 1;
> +                        goto EXIT;
> +                }
> +                break;
> +        default:
> +                /*
> +                 * Open message queue
> +                 */
> +                TEST(fd = mq_open(QUEUE_NAME, O_CREAT|O_EXCL|O_RDWR, S_IRWXU, NULL));
> +                if (TEST_RETURN < 0) {
> +                        tst_resm(TFAIL,"mq_open failed errno = %d : %s",TEST_ERRNO, strerror(TEST_ERRNO));
> +                        result = 1;
> +                        goto EXIT;
> +                }
> +        }
> +
> +	/*
> +         * Set up struct sigevent
> +         */
> +        ev.sigev_notify = tc->notify;
> +        switch (tc->notify) {
> +        case SIGEV_SIGNAL:
> +                notified = cmp_ok = 0;
> +                ev.sigev_signo = SIGUSR1;
> +                ev.sigev_value.sival_int = USER_DATA;
> +
> +                // set up the signal handler
> +                memset(&sigact, 0, sizeof(sigact));
> +                sigact.sa_sigaction = sigfunc;
> +                sigact.sa_flags = SA_SIGINFO;
> +                TEST(rc = sigaction(SIGUSR1, &sigact, NULL));
> +                break;
> +        case SIGEV_THREAD:
> +                notified = cmp_ok = 0;
> +                ev.sigev_notify_function = tfunc;
> +                ev.sigev_notify_attributes = NULL;
> +                ev.sigev_value.sival_int = USER_DATA;
> +                break;
> +        }
> +
> +	if (tc->ttype == ALREADY_REGISTERED) {
> +                TEST(rc = mq_notify(fd, &ev));
> +                if (TEST_RETURN < 0) {
> +                        tst_resm(TFAIL,"mq_notify failed errno = %d : %s",TEST_ERRNO, strerror(TEST_ERRNO));
> +                        result = 1;
> +                        goto EXIT;
> +                }
> +        }
> +	
> +	/*
> +         * Execute system call
> +         */
> +        errno = 0;
> +        sys_ret = mq_notify(fd, &ev);
> +        sys_errno = errno;
> +        if (sys_ret < 0)
> +                goto TEST_END;
> +
> +	 /*
> +         * Prepare send message
> +         */
> +        for (i = 0; i < MSG_SIZE; i++)
> +                smsg[i] = i;
> +        TEST(rc = mq_timedsend(fd, smsg, MSG_SIZE, 0, NULL));
> +        if (rc < 0) {
> +                tst_resm(TFAIL,"mq_timedsend failed errno = %d : %s",TEST_ERRNO, strerror(TEST_ERRNO));
> +                result = 1;
> +                goto EXIT;
> +        }
> +
> +        while (!notified)
> +                usleep(10000);
> +
> +TEST_END:
> +        /*
> +         * Check results
> +         */
> +        result |= (sys_errno != tc->err) || !cmp_ok;
> +        PRINT_RESULT_CMP(sys_ret >= 0, tc->ret, tc->err, sys_ret, sys_errno,
> +                         cmp_ok);
> +
> +EXIT:
> +        if (fd >= 0) {
> +                close(fd);
> +                mq_unlink(QUEUE_NAME);
> +        }
> +
> +        return result;
> +}
> +	
> +
> +
> +/*
> + * usage()
> + */
> +
> +static void usage(const char *progname)
> +{
> +        tst_resm(TINFO,"usage: %s [options]", progname);
> +        tst_resm(TINFO,"This is a regression test program of %s system call.",SYSCALL_NAME);
> +        tst_resm(TINFO,"options:");
> +        tst_resm(TINFO,"    -d --debug           Show debug messages");
> +        tst_resm(TINFO,"    -h --help            Show this message");
> +        tst_resm(TINFO,"NG");
> +        exit(1);
> +}
> +
> +
> +/*
> + * main()
> + */
> +
> +
> +
> +int main(int ac, char **av) {
> +	int result = RESULT_OK;
> +        int c;
> +        int i;
> +        int lc;                 /* loop counter */
> +        char *msg;              /* message returned from parse_opts */
> +
> +	struct option long_options[] = {
> +                { "debug", no_argument, 0, 'd' },
> +                { "help",  no_argument, 0, 'h' },
> +                { NULL, 0, NULL, 0 }
> +        };
> +
> +	progname = strchr(av[0], '/');
> +        progname = progname ? progname + 1 : av[0];	
> +	
> +        /* parse standard options */
> +        if ((msg = parse_opts(ac, av, (option_t *)NULL, NULL)) != (char *)NULL){
> +             tst_brkm(TBROK, cleanup, "OPTION PARSING ERROR - %s", msg);
> +             tst_exit();
> +           }
> +
> +        setup();
> +
> +        /* Check looping state if -i option given */
> +        for (lc = 0; TEST_LOOPING(lc); ++lc) {
> +                Tst_count = 0;
> +                for (testno = 0; testno < TST_TOTAL; ++testno) {
> +			 TEST(c = getopt_long(ac, av, "dh", long_options, NULL));
> +			 while(TEST_RETURN != -1) {
> +		                switch (c) {
> +                		case 'd':
> +		                        opt_debug = 1;
> +                		        break;
> +		                default:
> +                		        usage(progname);
> +                        		// NOTREACHED
> +                		}
> +		        }
> +
> +
> +		if (ac != optind) {
> +        	        tst_resm(TINFO,"Options are not match.");
> +                	usage(progname);
> +                	// NOTREACHED
> +	        }
> +
> +		/*
> +		* Execute test
> +         	*/
> +	        for (i = 0; i < (int)(sizeof(tcase) / sizeof(tcase[0])); i++) {
> +        	        int ret;
> +	                tst_resm(TINFO,"(case%02d) START", i);
> +	                ret = do_test(&tcase[i]);
> +	                tst_resm(TINFO,"(case%02d) END => %s", i, (ret == 0) ? "OK" : "NG");
> +	                result |= ret;
> +        	}
> +		
> +		/*
> +        	 * Check results
> +         	*/
> +        	switch(result) {
> +	        case RESULT_OK:
> +        			tst_resm(TPASS, "mq_notify call succeeded");
> +		                break;
> +
> +	        default:
> +                 	   	tst_resm(TFAIL, "%s failed - errno = %d : %s", TCID, TEST_ERRNO, strerror(TEST_ERRNO));
> +        		        tst_resm(TINFO,"NG");
> +				cleanup();
> +				tst_exit();
> +		                break;
> +        	}
> +
> +                }
> +        }	
> +        cleanup();
> +	tst_exit();
> +}
> +
> --- ltp-intermediate-20090521.orig/runtest/syscalls	2009-05-27 12:45:56.000000000 +0530
> +++ ltp-intermediate-20090521/runtest/syscalls	2009-05-27 12:55:31.000000000 +0530
> @@ -585,6 +585,8 @@ mprotect01 mprotect01
>  mprotect02 mprotect02
>  mprotect03 mprotect03
> 
> +mq_notify01 mq_notify01
> +
>  mremap01 mremap01
>  mremap02 mremap02
>  mremap03 mremap03
> 
> ---
> Regards--
> Manas
> 


------------------------------------------------------------------------------
Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT 
is a gathering of tech-side developers & brand creativity professionals. Meet
the minds behind Google Creative Lab, Visual Complexity, Processing, & 
iPhoneDevCamp as they present alongside digital heavyweights like Barbarian 
Group, R/GA, & Big Spaceship. http://p.sf.net/sfu/creativitycat-com 
_______________________________________________
Ltp-list mailing list
Ltp-list@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/ltp-list

  reply	other threads:[~2009-05-29 12:56 UTC|newest]

Thread overview: 31+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-05-27 10:06 [LTP] [PATCH 00/13][2nd Bunch] Port Crackerjack Syscall tests(missing) to LTP Manas Kumar Nayak
2009-05-27 10:07 ` [LTP] [PATCH 01/13] Add/Port Utility Headers for these set of tests Manas Kumar Nayak
2009-05-29 12:55   ` Subrata Modak
2009-05-27 10:07 ` [LTP] [PATCH 02/13] Add/Port get_mempolicy01 test for get_mempolicy() syscall Manas Kumar Nayak
2009-05-29 12:55   ` Subrata Modak
2009-05-27 10:08 ` [LTP] [PATCH 03/13] Add/Port clock_getres01 test for clock_getres() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-05-27 10:08 ` [LTP] [PATCH 04/13] Add/Port clock_nanosleep01 test for clock_nanosleep() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-05-27 10:09 ` [LTP] [PATCH 05/13] Add/Port mq_notify01 test for mq_notify() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak [this message]
2009-05-27 10:09 ` [LTP] [PATCH 06/13] Add/Port ppoll01 test for ppoll() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-08-06  9:56     ` Michal Simek
2009-08-07 12:41       ` Subrata Modak
2009-08-07 20:52         ` Henry Yei
2009-05-27 10:10 ` [LTP] [PATCH 07/13] Add/Port mq_open01 test for mq_open() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-05-27 10:10 ` [LTP] [PATCH 08/13] Add/Port mq_timedreceive01 test for mq_timedreceive() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-05-27 10:11 ` [LTP] [PATCH 09/13] Add/Port utimes01 test for utimes() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-05-27 10:11 ` [LTP] [PATCH 10/13] Add/Port mq_unlink01 test for mq_unlink() syscall Manas Kumar Nayak
2009-05-29 12:56   ` Subrata Modak
2009-05-27 10:12 ` [LTP] [PATCH 11/13] Add/Port mq_timedsend01 test for mq_timedsend() syscall Manas Kumar Nayak
2009-05-29 12:57   ` Subrata Modak
2009-05-27 10:12 ` [LTP] [PATCH 12/13] Add/Port unshare01 test for unshare() syscall Manas Kumar Nayak
2009-05-29 12:57   ` Subrata Modak
2009-05-27 10:13 ` [LTP] [PATCH 13/13] Add/Port unshare02 " Manas Kumar Nayak
2009-05-29 12:57   ` Subrata Modak
2009-05-29 12:55 ` [LTP] [PATCH 00/13][2nd Bunch] Port Crackerjack Syscall tests(missing) to LTP Subrata Modak

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1243601776.5188.47.camel@subratamodak.linux.ibm.com \
    --to=subrata@linux.vnet.ibm.com \
    --cc=ltp-list@lists.sourceforge.net \
    --cc=maknayak@in.ibm.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox