4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/*
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * CDDL HEADER START
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * The contents of this file are subject to the terms of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Common Development and Distribution License, Version 1.0 only
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * (the "License"). You may not use this file except in compliance
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * with the License.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * or http://forgerock.org/license/CDDLv1.0.html.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * See the License for the specific language governing permissions
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * and limitations under the License.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * When distributing Covered Code, include this CDDL HEADER in each
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * file and include the License file at legal-notices/CDDLv1_0.txt.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * If applicable, add the following below this CDDL HEADER, with the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * fields enclosed by brackets "[]" replaced with your own identifying
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * information:
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Portions Copyright [yyyy] [name of copyright owner]
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * CDDL HEADER END
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Copyright 2008 Sun Microsystems, Inc.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Portions Copyright 2011 ForgeRock AS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync WHAT is winlauncher.exe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ========================
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncwinlauncher.exe is a small windows executable that is intended to be used by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncthe command line files to perform certain operations. It is not intended to
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncbe a final user interface and that is one of the reasons why is placed under
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncthe lib subdirectory.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSee the comments in winlauncher.c file and common.c for more information.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync WHAT is opendj_service.exe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ========================
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncopendj_service.exe is a small windows executable that is intended to be used by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncthe command line files to be able to run OpenDJ as a windows service (or not
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncto configure it as windows service). It is not intended to be a final user
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncinterface and that is one of the reasons why is placed under the lib
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncsubdirectory.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSee the comments in service.c file and common.c for more information.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync WHAT is launcher_administrator.exe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ========================
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsynclauncher_administrator.exe is a small windows executable that is intended to
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncbe used by the command line files to launch operations that require
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncadministrator privileges on Vista. Basically is a wrapper containing a
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncmanifest that specifies to require administrator privileges to be run. This
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncis required if UAC is enabled on Vista so that we have a prompt for the user
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncasking for confirmation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSee the comments in winlauncher.c file and common.c for more information.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync INSTRUCTIONS TO COMPILE winlauncher.exe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ========================
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUsing Visual C++ and the command line you must set your environment
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncvariables to point to your Visual Studio install. You can set the environment
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncvariables by changing to the \bin subdirectory of your Visual C++ installation
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncand running the VCVARS32.bat batch file.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis will basically update your PATH, INCLUDE and LIB environment variables
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncto point to the correct paths of your Visual Studio install.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncGo to the directory where the source files winlauncher.c, winlauncher.h,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsynccommon.c and common.h are and launch the following command:
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync> cl winlauncher.c common.c
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis will generate the binary winlauncher.exe.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncNOTE: An alternative to this mode is to compile winlauncher.exe using the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncMakefile by running:
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync> nmake all
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync(See INSTRUCTIONS TO COMPILE opendj_service.exe for more information).
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync************************
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUsing Visual C++ graphical interface you just must to Create a Project and add
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncwinlauncher.c, winlauncher.h, common.c and common.h to the project.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncYou can build winlauncher.c and then winlauncher.exe with the commands in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncmenu 'Build'.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync************************
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUsing gcc (for instance you can get it with the open source project MinGW -
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncMinimalist GNU for Windows), you must include the directory where the gcc
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncbinaries are on your PATH environment variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncGo to the directory where the source files winlauncher.c and winlauncher.h are
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncand launch the following command:
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync> gcc common.c winlauncher.c -o winlauncher.exe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis will generate the binary winlauncher.exe.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync INSTRUCTIONS TO COMPILE opendj_service.exe and administrator_launcher.exe
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ========================
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncservice.c (the main code file for opendj_service.exe) uses windows resources and
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncso it requires Windows libraries to be compiled.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThe fastest way of generating opendj_service.exe is to do it using the command
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncline.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUsing Visual C++ and the command line you must set your environment
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncvariables to point to your Visual Studio install. You can set the environment
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncvariables by changing to the \bin subdirectory of your Visual C++ installation
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncand running the VCVARS32.bat batch file.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThen go to the directory where the source files are and run the following
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsynccommand:
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync> nmake all
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis command will generate both opendj_service.exe and winlauncher.exe.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSee the comments in the file Makefile for more information.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync