README revision 3231
2247N/A/*
2247N/A * CDDL HEADER START
2247N/A *
2247N/A * The contents of this file are subject to the terms of the
2247N/A * Common Development and Distribution License, Version 1.0 only
2247N/A * (the "License"). You may not use this file except in compliance
2247N/A * with the License.
2247N/A *
2247N/A * You can obtain a copy of the license at
2247N/A * trunk/opends/resource/legal-notices/OpenDS.LICENSE
2247N/A * or https://OpenDS.dev.java.net/OpenDS.LICENSE.
2247N/A * See the License for the specific language governing permissions
2247N/A * and limitations under the License.
2247N/A *
2247N/A * When distributing Covered Code, include this CDDL HEADER in each
2247N/A * file and include the License file at
2247N/A * trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,
2247N/A * add the following below this CDDL HEADER, with the fields enclosed
2247N/A * by brackets "[]" replaced with your own identifying information:
2247N/A * Portions Copyright [yyyy] [name of copyright owner]
2247N/A *
2247N/A * CDDL HEADER END
2247N/A *
2247N/A *
2247N/A * Copyright 2008 Sun Microsystems, Inc.
2247N/A */
2247N/A
2247N/A WHAT is winlauncher.exe
2247N/A ========================
2247N/Awinlauncher.exe is a small windows executable that is intended to be used by
2247N/Athe command line files to perform certain operations. It is not intended to
2247N/Abe a final user interface and that is one of the reasons why is placed under
2247N/Athe lib subdirectory.
2247N/A
2247N/ASee the comments in winlauncher.c file and common.c for more information.
2247N/A
2247N/A WHAT is opends_service.exe
2247N/A ========================
2247N/Aopends_service.exe is a small windows executable that is intended to be used by
2247N/Athe command line files to be able to run OpenDS as a windows service (or not
2247N/Ato configure it as windows service). It is not intended to be a final user
2247N/Ainterface and that is one of the reasons why is placed under the lib
2247N/Asubdirectory.
2247N/A
2247N/ASee the comments in service.c file and common.c for more information.
2247N/A
2247N/A WHAT is launcher_administrator.exe
2247N/A ========================
2247N/Alauncher_administrator.exe is a small windows executable that is intended to
2247N/Abe used by the command line files to launch operations that require
2247N/Aadministrator privileges on Vista. Basically is a wrapper containing a
2247N/Amanifest that specifies to require administrator privileges to be run. This
2247N/Ais required if UAC is enabled on Vista so that we have a prompt for the user
2247N/Aasking for confirmation.
2247N/A
2247N/ASee the comments in winlauncher.c file and common.c for more information.
2247N/A
2247N/A INSTRUCTIONS TO COMPILE winlauncher.exe
2247N/A ========================
2247N/A
2247N/AUsing Visual C++ and the command line you must set your environment
2247N/Avariables to point to your Visual Studio install. You can set the environment
2247N/Avariables by changing to the \bin subdirectory of your Visual C++ installation
2247N/Aand running the VCVARS32.bat batch file.
2247N/A
2247N/AThis will basically update your PATH, INCLUDE and LIB environment variables
2247N/Ato point to the correct paths of your Visual Studio install.
2247N/A
2247N/AGo to the directory where the source files winlauncher.c, winlauncher.h,
2247N/Acommon.c and common.h are and launch the following command:
2247N/A
2247N/A> cl winlauncher.c common.c
2247N/A
2247N/AThis will generate the binary winlauncher.exe.
2247N/A
NOTE: An alternative to this mode is to compile winlauncher.exe using the
Makefile by running:
> nmake all
(See INSTRUCTIONS TO COMPILE opends_service.exe for more information).
************************
Using Visual C++ graphical interface you just must to Create a Project and add
winlauncher.c, winlauncher.h, common.c and common.h to the project.
You can build winlauncher.c and then winlauncher.exe with the commands in the
menu 'Build'.
************************
Using gcc (for instance you can get it with the open source project MinGW -
Minimalist GNU for Windows), you must include the directory where the gcc
binaries are on your PATH environment variable.
Go to the directory where the source files winlauncher.c and winlauncher.h are
and launch the following command:
> gcc common.c winlauncher.c -o winlauncher.exe
This will generate the binary winlauncher.exe.
INSTRUCTIONS TO COMPILE opends_service.exe and administrator_launcher.exe
========================
service.c (the main code file for opends_service.exe) uses windows resources and
so
The fastest way of generating opends_service.exe is to do it using the command
line.
Using Visual C++ and the command line you must set your environment
variables to point to your Visual Studio install. You can set the environment
variables by changing to the \bin subdirectory of your Visual C++ installation
and running the VCVARS32.bat batch file.
Then go to the directory where the source files are and run the following
command:
> nmake all
This command will generate both opends_service.exe and winlauncher.exe.
See the comments in the file Makefile for more information.