aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--bin/.gitignore4
-rw-r--r--lib/.gitignore4
-rw-r--r--obj/.gitignore4
-rw-r--r--proj/common.gpr102
-rw-r--r--readme.md49
-rw-r--r--src/here_i_am.adb76
-rw-r--r--src/here_i_am.ads22
-rw-r--r--src/whereami.c815
-rw-r--r--src/whereami.h69
-rw-r--r--test/where_exec.adb20
-rw-r--r--test/where_mod.adb20
-rw-r--r--testlib.gpr26
-rw-r--r--tests.gpr39
-rw-r--r--unlicense.txt24
14 files changed, 1274 insertions, 0 deletions
diff --git a/bin/.gitignore b/bin/.gitignore
new file mode 100644
index 0000000..ea7f887
--- /dev/null
+++ b/bin/.gitignore
@@ -0,0 +1,4 @@
+
+
+*
+!.gitignore
diff --git a/lib/.gitignore b/lib/.gitignore
new file mode 100644
index 0000000..ea7f887
--- /dev/null
+++ b/lib/.gitignore
@@ -0,0 +1,4 @@
+
+
+*
+!.gitignore
diff --git a/obj/.gitignore b/obj/.gitignore
new file mode 100644
index 0000000..ea7f887
--- /dev/null
+++ b/obj/.gitignore
@@ -0,0 +1,4 @@
+
+
+*
+!.gitignore
diff --git a/proj/common.gpr b/proj/common.gpr
new file mode 100644
index 0000000..d689556
--- /dev/null
+++ b/proj/common.gpr
@@ -0,0 +1,102 @@
+
+
+abstract project Common is
+
+
+ type Build_Kind is ("release", "debug");
+
+ Ver : Build_Kind := external ("build", "release");
+
+
+ package Builder is
+ for Default_Switches ("Ada") use ("-j4", "-m");
+ for Global_Compilation_Switches ("Ada") use ("-shared");
+
+ case Ver is
+
+ when "release" =>
+ null;
+
+ when "debug" =>
+ for Default_Switches ("Ada") use Builder'Default_Switches ("Ada") & "-g";
+
+ end case;
+ end Builder;
+
+
+ Ada_Common :=
+ ("-gnaty"
+ & "4" -- indentation
+ & "a" -- attribute casing
+ & "A" -- array attribute indices
+ & "b" -- blanks at end of lines
+ & "c" -- two space comments
+ & "e" -- end/exit labels
+ & "f" -- no form feeds or vertical tabs
+ & "h" -- no horizontal tabs
+ & "i" -- if/then layout
+ & "k" -- keyword casing
+ & "l" -- reference manual layout
+ & "M100" -- max line length
+ & "n" -- package Standard casing
+ & "p" -- pragma casing
+ & "r" -- identifier casing
+ & "t", -- token separation
+ "-gnatw"
+ & "a" -- various warning modes
+ & "F" -- don't check for unreferenced formal parameters
+ & "J" -- don't check for obsolescent feature use
+ & "U"); -- don't check for unused entities
+
+ C_Common :=
+ ("-Wall",
+ "-Werror",
+ "-Wextra",
+ "-Wpedantic");
+
+ package Compiler is
+ case Ver is
+
+ when "release" =>
+ for Default_Switches ("Ada") use Ada_Common & "-O3" & "-Os" & "-gnatn";
+ for Default_Switches ("C") use C_Common & "-O3" & "-Os";
+
+ when "debug" =>
+ for Default_Switches ("Ada") use Ada_Common & "-O0" & "-gnata" & "-gnato" & "-g";
+ for Default_Switches ("C") use C_Common & "-O0";
+
+ end case;
+ end Compiler;
+
+
+ package Binder is
+ for Default_Switches ("Ada") use ("-shared");
+
+ case Ver is
+
+ when "release" =>
+ null;
+
+ when "debug" =>
+ for Default_Switches ("Ada") use Binder'Default_Switches ("Ada") & "-E";
+
+ end case;
+ end Binder;
+
+
+ package Linker is
+ case Ver is
+
+ when "release" =>
+ null;
+
+ when "debug" =>
+ for Default_Switches ("Ada") use ("-g");
+
+ end case;
+ end Linker;
+
+
+end Common;
+
+
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..5dbf1fb
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,49 @@
+
+## Here I Am!
+
+This is an Ada wrapper applied to the
+[Where Am I?](https://github.com/gpakosz/whereami) library by Gregory Pakosz.
+As with the original C, this allows for easily locating where the running
+executable or module is stored in the filesystem.
+
+Note that this functionality is **not** something you can do with the Ada
+standard library!
+
+The `Command_Name` subprogram in `Ada.Command_Line` will only get you the
+command used to invoke the executable, which might be a symlink and/or might
+have had a platform-specific `$PATH` used to find it. The `Current_Directory`
+and `Containing_Directory` subprograms in `Ada.Directories` will only get you
+the current working directory. That may be completely different from where the
+executable is located if an absolute or relative path was supplied with the
+command or, again, a platform-specific `$PATH` was involved.
+
+Of the options in the standard library the most reliable one would be to use
+`Ada.Environment_Variables` and process each possible platform-specific `$PATH`
+manually. But that still wouldn't resolve any symlinks or other shortcut files.
+
+
+
+#### Building and Installation
+
+If this was a dynamic library then the function to locate the current module
+would always return the location of that shared object. On the other hand if
+this was a static library then it wouldn't be possible to compile as part of a
+dynamic libary.
+
+Thus, to use this you should instead just copy the contents of `src` wholesale
+to a suitable spot in your own project.
+
+The `tests.gpr` project file can be used to build some very basic sanity checks
+if desired.
+
+
+
+#### Credits and Licensing
+
+Ada wrapper code written by Jedidiah Barber and released into the public domain
+as per `unlicense.txt`.
+
+C code written by Gregory Pakosz and licensed under the WTFPL which lets you do
+whatever you want, so it's basically public domain as well.
+
+
diff --git a/src/here_i_am.adb b/src/here_i_am.adb
new file mode 100644
index 0000000..0117fc3
--- /dev/null
+++ b/src/here_i_am.adb
@@ -0,0 +1,76 @@
+
+
+-- Programmed by Jedidiah Barber
+-- Released into the public domain
+
+
+with
+
+ Interfaces.C.Strings,
+ System.Storage_Elements;
+
+
+package body Here_I_Am is
+
+
+ package Storage renames System.Storage_Elements;
+
+ Null_Pointer : constant Storage.Integer_Address := Storage.To_Integer (System.Null_Address);
+
+
+
+
+ function wai_getExecutablePath
+ (Buffer : in Interfaces.C.Strings.chars_ptr;
+ Length : in Interfaces.C.int;
+ Dir : in Storage.Integer_Address)
+ return Interfaces.C.int;
+ pragma Import (C, wai_getExecutablePath, "wai_getExecutablePath");
+ pragma Inline (wai_getExecutablePath);
+
+ function wai_getModulePath
+ (Buffer : in Interfaces.C.Strings.chars_ptr;
+ Length : in Interfaces.C.int;
+ Dir : in Storage.Integer_Address)
+ return Interfaces.C.int;
+ pragma Import (C, wai_getModulePath, "wai_getModulePath");
+ pragma Inline (wai_getModulePath);
+
+
+
+
+ function Executable
+ return String
+ is
+ Path_Length : constant Interfaces.C.int :=
+ wai_getExecutablePath (Interfaces.C.Strings.Null_Ptr, 0, Null_Pointer);
+ Data_Buffer : aliased Interfaces.C.char_array :=
+ (1 .. Interfaces.C.size_t (Path_Length) => Interfaces.C.nul);
+ Ignore : constant Interfaces.C.int := wai_getExecutablePath
+ (Interfaces.C.Strings.To_Chars_Ptr (Data_Buffer'Unchecked_Access),
+ Path_Length,
+ Null_Pointer);
+ begin
+ return Interfaces.C.To_Ada (Data_Buffer, False);
+ end Executable;
+
+
+ function Module
+ return String
+ is
+ Path_Length : constant Interfaces.C.int :=
+ wai_getModulePath (Interfaces.C.Strings.Null_Ptr, 0, Null_Pointer);
+ Data_Buffer : aliased Interfaces.C.char_array :=
+ (1 .. Interfaces.C.size_t (Path_Length) => Interfaces.C.nul);
+ Ignore : constant Interfaces.C.int := wai_getModulePath
+ (Interfaces.C.Strings.To_Chars_Ptr (Data_Buffer'Unchecked_Access),
+ Path_Length,
+ Null_Pointer);
+ begin
+ return Interfaces.C.To_Ada (Data_Buffer, False);
+ end Module;
+
+
+end Here_I_Am;
+
+
diff --git a/src/here_i_am.ads b/src/here_i_am.ads
new file mode 100644
index 0000000..7276a9a
--- /dev/null
+++ b/src/here_i_am.ads
@@ -0,0 +1,22 @@
+
+
+-- Programmed by Jedidiah Barber
+-- Released into the public domain
+
+
+package Here_I_Am is
+
+
+ -- Provides the full name and path of the running executable
+ function Executable
+ return String;
+
+
+ -- Provides the full name and path of the running library
+ function Module
+ return String;
+
+
+end Here_I_Am;
+
+
diff --git a/src/whereami.c b/src/whereami.c
new file mode 100644
index 0000000..a8a649d
--- /dev/null
+++ b/src/whereami.c
@@ -0,0 +1,815 @@
+// (‑●‑●)> dual licensed under the WTFPL v2 and MIT licenses
+// without any warranty.
+// by Gregory Pakosz (@gpakosz)
+// https://github.com/gpakosz/whereami
+
+// in case you want to #include "whereami.c" in a larger compilation unit
+#if !defined(WHEREAMI_H)
+#include <whereami.h>
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if defined(__linux__) || defined(__CYGWIN__)
+#undef _DEFAULT_SOURCE
+#define _DEFAULT_SOURCE
+#elif defined(__APPLE__)
+#undef _DARWIN_C_SOURCE
+#define _DARWIN_C_SOURCE
+#define _DARWIN_BETTER_REALPATH
+#endif
+
+#if !defined(WAI_MALLOC) || !defined(WAI_FREE) || !defined(WAI_REALLOC)
+#include <stdlib.h>
+#endif
+
+#if !defined(WAI_MALLOC)
+#define WAI_MALLOC(size) malloc(size)
+#endif
+
+#if !defined(WAI_FREE)
+#define WAI_FREE(p) free(p)
+#endif
+
+#if !defined(WAI_REALLOC)
+#define WAI_REALLOC(p, size) realloc(p, size)
+#endif
+
+#ifndef WAI_NOINLINE
+#if defined(_MSC_VER)
+#define WAI_NOINLINE __declspec(noinline)
+#elif defined(__GNUC__)
+#define WAI_NOINLINE __attribute__((noinline))
+#else
+#error unsupported compiler
+#endif
+#endif
+
+#if defined(_MSC_VER)
+#define WAI_RETURN_ADDRESS() _ReturnAddress()
+#elif defined(__GNUC__)
+#define WAI_RETURN_ADDRESS() __builtin_extract_return_addr(__builtin_return_address(0))
+#else
+#error unsupported compiler
+#endif
+
+#if defined(_WIN32)
+
+#ifndef WIN32_LEAN_AND_MEAN
+#define WIN32_LEAN_AND_MEAN
+#endif
+#if defined(_MSC_VER)
+#pragma warning(push, 3)
+#endif
+#include <windows.h>
+#include <intrin.h>
+#if defined(_MSC_VER)
+#pragma warning(pop)
+#endif
+#if (_MSC_VER >= 1900)
+#include <stdbool.h>
+#else
+#define bool int
+#define false 0
+#define true 1
+#endif
+
+static int WAI_PREFIX(getModulePath_)(HMODULE module, char* out, int capacity, int* dirname_length)
+{
+ wchar_t buffer1[MAX_PATH];
+ wchar_t buffer2[MAX_PATH];
+ wchar_t* path = NULL;
+ int length = -1;
+ bool ok;
+
+ for (ok = false; !ok; ok = true)
+ {
+ DWORD size;
+ int length_, length__;
+
+ size = GetModuleFileNameW(module, buffer1, sizeof(buffer1) / sizeof(buffer1[0]));
+
+ if (size == 0)
+ break;
+ else if (size == (DWORD)(sizeof(buffer1) / sizeof(buffer1[0])))
+ {
+ DWORD size_ = size;
+ do
+ {
+ wchar_t* path_;
+
+ path_ = (wchar_t*)WAI_REALLOC(path, sizeof(wchar_t) * size_ * 2);
+ if (!path_)
+ break;
+ size_ *= 2;
+ path = path_;
+ size = GetModuleFileNameW(module, path, size_);
+ }
+ while (size == size_);
+
+ if (size == size_)
+ break;
+ }
+ else
+ path = buffer1;
+
+ if (!_wfullpath(buffer2, path, MAX_PATH))
+ break;
+ length_ = (int)wcslen(buffer2);
+ length__ = WideCharToMultiByte(CP_UTF8, 0, buffer2, length_ , out, capacity, NULL, NULL);
+
+ if (length__ == 0)
+ length__ = WideCharToMultiByte(CP_UTF8, 0, buffer2, length_, NULL, 0, NULL, NULL);
+ if (length__ == 0)
+ break;
+
+ if (length__ <= capacity && dirname_length)
+ {
+ int i;
+
+ for (i = length__ - 1; i >= 0; --i)
+ {
+ if (out[i] == '\\')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+
+ length = length__;
+ }
+
+ if (path != buffer1)
+ WAI_FREE(path);
+
+ return ok ? length : -1;
+}
+
+WAI_NOINLINE WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length)
+{
+ return WAI_PREFIX(getModulePath_)(NULL, out, capacity, dirname_length);
+}
+
+WAI_NOINLINE WAI_FUNCSPEC
+int WAI_PREFIX(getModulePath)(char* out, int capacity, int* dirname_length)
+{
+ HMODULE module;
+ int length = -1;
+
+#if defined(_MSC_VER)
+#pragma warning(push)
+#pragma warning(disable: 4054)
+#endif
+ if (GetModuleHandleEx(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS | GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT, (LPCTSTR)WAI_RETURN_ADDRESS(), &module))
+#if defined(_MSC_VER)
+#pragma warning(pop)
+#endif
+ {
+ length = WAI_PREFIX(getModulePath_)(module, out, capacity, dirname_length);
+ }
+
+ return length;
+}
+
+#elif defined(__linux__) || defined(__CYGWIN__) || defined(__sun) || defined(WAI_USE_PROC_SELF_EXE)
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#if defined(__linux__)
+#include <linux/limits.h>
+#else
+#include <limits.h>
+#endif
+#ifndef __STDC_FORMAT_MACROS
+#define __STDC_FORMAT_MACROS
+#endif
+#include <inttypes.h>
+#include <stdbool.h>
+
+#if !defined(WAI_PROC_SELF_EXE)
+#if defined(__sun)
+#define WAI_PROC_SELF_EXE "/proc/self/path/a.out"
+#else
+#define WAI_PROC_SELF_EXE "/proc/self/exe"
+#endif
+#endif
+
+WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer[PATH_MAX];
+ char* resolved = NULL;
+ int length = -1;
+ bool ok;
+
+ for (ok = false; !ok; ok = true)
+ {
+ resolved = realpath(WAI_PROC_SELF_EXE, buffer);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ return ok ? length : -1;
+}
+
+#if !defined(WAI_PROC_SELF_MAPS_RETRY)
+#define WAI_PROC_SELF_MAPS_RETRY 5
+#endif
+
+#if !defined(WAI_PROC_SELF_MAPS)
+#if defined(__sun)
+#define WAI_PROC_SELF_MAPS "/proc/self/map"
+#else
+#define WAI_PROC_SELF_MAPS "/proc/self/maps"
+#endif
+#endif
+
+#if !defined(WAI_STRINGIZE)
+#define WAI_STRINGIZE(s)
+#define WAI_STRINGIZE_(s) #s
+#endif
+
+#if defined(__ANDROID__) || defined(ANDROID)
+#include <fcntl.h>
+#include <sys/mman.h>
+#include <unistd.h>
+#endif
+#include <stdbool.h>
+
+WAI_NOINLINE WAI_FUNCSPEC
+int WAI_PREFIX(getModulePath)(char* out, int capacity, int* dirname_length)
+{
+ int length = -1;
+ FILE* maps = NULL;
+
+ for (int r = 0; r < WAI_PROC_SELF_MAPS_RETRY; ++r)
+ {
+ maps = fopen(WAI_PROC_SELF_MAPS, "r");
+ if (!maps)
+ break;
+
+ for (;;)
+ {
+ char buffer[128 + PATH_MAX];
+ uintptr_t low, high;
+ char perms[5];
+ uint64_t offset;
+ uint32_t major, minor, inode;
+ char path[PATH_MAX + 1];
+
+ if (!fgets(buffer, sizeof(buffer), maps))
+ break;
+
+ if (sscanf(buffer, "%" SCNxPTR "-%" SCNxPTR " %s %" SCNx64 " %x:%x %u %" WAI_STRINGIZE(PATH_MAX) "[^\n]\n", &low, &high, perms, &offset, &major, &minor, &inode, path) == 8)
+ {
+ void* _addr = WAI_RETURN_ADDRESS();
+ uintptr_t addr = (uintptr_t)_addr;
+ if (low <= addr && addr <= high)
+ {
+ char* resolved;
+
+ resolved = realpath(path, buffer);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+#if defined(__ANDROID__) || defined(ANDROID)
+ if (length > 4
+ &&buffer[length - 1] == 'k'
+ &&buffer[length - 2] == 'p'
+ &&buffer[length - 3] == 'a'
+ &&buffer[length - 4] == '.')
+ {
+ int fd = open(path, O_RDONLY);
+ if (fd == -1)
+ {
+ length = -1; // retry
+ break;
+ }
+
+ char* begin = (char*)mmap(0, offset, PROT_READ, MAP_SHARED, fd, 0);
+ if (begin == MAP_FAILED)
+ {
+ close(fd);
+ length = -1; // retry
+ break;
+ }
+
+ char* p = begin + offset - 30; // minimum size of local file header
+ while (p >= begin) // scan backwards
+ {
+ if (*((uint32_t*)p) == 0x04034b50UL) // local file header signature found
+ {
+ uint16_t length_ = *((uint16_t*)(p + 26));
+
+ if (length + 2 + length_ < (int)sizeof(buffer))
+ {
+ memcpy(&buffer[length], "!/", 2);
+ memcpy(&buffer[length + 2], p + 30, length_);
+ length += 2 + length_;
+ }
+
+ break;
+ }
+
+ --p;
+ }
+
+ munmap(begin, offset);
+ close(fd);
+ }
+#endif
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+
+ break;
+ }
+ }
+ }
+
+ fclose(maps);
+ maps = NULL;
+
+ if (length != -1)
+ break;
+ }
+
+ return length;
+}
+
+#elif defined(__APPLE__)
+
+#include <mach-o/dyld.h>
+#include <limits.h>
+#include <stdlib.h>
+#include <string.h>
+#include <dlfcn.h>
+#include <stdbool.h>
+
+WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer1[PATH_MAX];
+ char buffer2[PATH_MAX];
+ char* path = buffer1;
+ char* resolved = NULL;
+ int length = -1;
+ bool ok;
+
+ for (ok = false; !ok; ok = true)
+ {
+ uint32_t size = (uint32_t)sizeof(buffer1);
+ if (_NSGetExecutablePath(path, &size) == -1)
+ {
+ path = (char*)WAI_MALLOC(size);
+ if (!_NSGetExecutablePath(path, &size))
+ break;
+ }
+
+ resolved = realpath(path, buffer2);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ if (path != buffer1)
+ WAI_FREE(path);
+
+ return ok ? length : -1;
+}
+
+WAI_NOINLINE WAI_FUNCSPEC
+int WAI_PREFIX(getModulePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer[PATH_MAX];
+ char* resolved = NULL;
+ int length = -1;
+
+ for(;;)
+ {
+ Dl_info info;
+
+ if (dladdr(WAI_RETURN_ADDRESS(), &info))
+ {
+ resolved = realpath(info.dli_fname, buffer);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ break;
+ }
+
+ return length;
+}
+
+#elif defined(__QNXNTO__)
+
+#include <limits.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <dlfcn.h>
+#include <stdbool.h>
+
+#if !defined(WAI_PROC_SELF_EXE)
+#define WAI_PROC_SELF_EXE "/proc/self/exefile"
+#endif
+
+WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer1[PATH_MAX];
+ char buffer2[PATH_MAX];
+ char* resolved = NULL;
+ FILE* self_exe = NULL;
+ int length = -1;
+ bool ok;
+
+ for (ok = false; !ok; ok = true)
+ {
+ self_exe = fopen(WAI_PROC_SELF_EXE, "r");
+ if (!self_exe)
+ break;
+
+ if (!fgets(buffer1, sizeof(buffer1), self_exe))
+ break;
+
+ resolved = realpath(buffer1, buffer2);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ fclose(self_exe);
+
+ return ok ? length : -1;
+}
+
+WAI_FUNCSPEC
+int WAI_PREFIX(getModulePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer[PATH_MAX];
+ char* resolved = NULL;
+ int length = -1;
+
+ for(;;)
+ {
+ Dl_info info;
+
+ if (dladdr(WAI_RETURN_ADDRESS(), &info))
+ {
+ resolved = realpath(info.dli_fname, buffer);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ break;
+ }
+
+ return length;
+}
+
+#elif defined(__DragonFly__) || defined(__FreeBSD__) || \
+ defined(__FreeBSD_kernel__) || defined(__NetBSD__) || defined(__OpenBSD__)
+
+#include <limits.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sys/types.h>
+#include <sys/sysctl.h>
+#include <dlfcn.h>
+#include <stdbool.h>
+
+#if defined(__OpenBSD__)
+
+#include <unistd.h>
+
+WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer1[4096];
+ char buffer2[PATH_MAX];
+ char buffer3[PATH_MAX];
+ char** argv = (char**)buffer1;
+ char* resolved = NULL;
+ int length = -1;
+ bool ok;
+
+ for (ok = false; !ok; ok = true)
+ {
+ int mib[4] = { CTL_KERN, KERN_PROC_ARGS, getpid(), KERN_PROC_ARGV };
+ size_t size;
+
+ if (sysctl(mib, 4, NULL, &size, NULL, 0) != 0)
+ break;
+
+ if (size > sizeof(buffer1))
+ {
+ argv = (char**)WAI_MALLOC(size);
+ if (!argv)
+ break;
+ }
+
+ if (sysctl(mib, 4, argv, &size, NULL, 0) != 0)
+ break;
+
+ if (strchr(argv[0], '/'))
+ {
+ resolved = realpath(argv[0], buffer2);
+ if (!resolved)
+ break;
+ }
+ else
+ {
+ const char* PATH = getenv("PATH");
+ if (!PATH)
+ break;
+
+ size_t argv0_length = strlen(argv[0]);
+
+ const char* begin = PATH;
+ while (1)
+ {
+ const char* separator = strchr(begin, ':');
+ const char* end = separator ? separator : begin + strlen(begin);
+
+ if (end - begin > 0)
+ {
+ if (*(end -1) == '/')
+ --end;
+
+ if (((end - begin) + 1 + argv0_length + 1) <= sizeof(buffer2))
+ {
+ memcpy(buffer2, begin, end - begin);
+ buffer2[end - begin] = '/';
+ memcpy(buffer2 + (end - begin) + 1, argv[0], argv0_length + 1);
+
+ resolved = realpath(buffer2, buffer3);
+ if (resolved)
+ break;
+ }
+ }
+
+ if (!separator)
+ break;
+
+ begin = ++separator;
+ }
+
+ if (!resolved)
+ break;
+ }
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ if (argv != (char**)buffer1)
+ WAI_FREE(argv);
+
+ return ok ? length : -1;
+}
+
+#else
+
+WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer1[PATH_MAX];
+ char buffer2[PATH_MAX];
+ char* path = buffer1;
+ char* resolved = NULL;
+ int length = -1;
+ bool ok;
+
+ for (ok = false; !ok; ok = true)
+ {
+#if defined(__NetBSD__)
+ int mib[4] = { CTL_KERN, KERN_PROC_ARGS, -1, KERN_PROC_PATHNAME };
+#else
+ int mib[4] = { CTL_KERN, KERN_PROC, KERN_PROC_PATHNAME, -1 };
+#endif
+ size_t size = sizeof(buffer1);
+
+ if (sysctl(mib, 4, path, &size, NULL, 0) != 0)
+ break;
+
+ resolved = realpath(path, buffer2);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ return ok ? length : -1;
+}
+
+#endif
+
+WAI_NOINLINE WAI_FUNCSPEC
+int WAI_PREFIX(getModulePath)(char* out, int capacity, int* dirname_length)
+{
+ char buffer[PATH_MAX];
+ char* resolved = NULL;
+ int length = -1;
+
+ for(;;)
+ {
+ Dl_info info;
+
+ if (dladdr(WAI_RETURN_ADDRESS(), &info))
+ {
+ resolved = realpath(info.dli_fname, buffer);
+ if (!resolved)
+ break;
+
+ length = (int)strlen(resolved);
+ if (length <= capacity)
+ {
+ memcpy(out, resolved, length);
+
+ if (dirname_length)
+ {
+ int i;
+
+ for (i = length - 1; i >= 0; --i)
+ {
+ if (out[i] == '/')
+ {
+ *dirname_length = i;
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ break;
+ }
+
+ return length;
+}
+
+#else
+
+#error unsupported platform
+
+#endif
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/src/whereami.h b/src/whereami.h
new file mode 100644
index 0000000..8e58c81
--- /dev/null
+++ b/src/whereami.h
@@ -0,0 +1,69 @@
+// (‑●‑●)> dual licensed under the WTFPL v2 and MIT licenses
+// without any warranty.
+// by Gregory Pakosz (@gpakosz)
+// https://github.com/gpakosz/whereami
+
+#ifndef WHEREAMI_H
+#define WHEREAMI_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifndef WAI_FUNCSPEC
+ #define WAI_FUNCSPEC
+#endif
+#ifndef WAI_PREFIX
+#define WAI_PREFIX(function) wai_##function
+#endif
+
+/**
+ * Returns the path to the current executable.
+ *
+ * Usage:
+ * - first call `int length = wai_getExecutablePath(NULL, 0, NULL);` to
+ * retrieve the length of the path
+ * - allocate the destination buffer with `path = (char*)malloc(length + 1);`
+ * - call `wai_getExecutablePath(path, length, NULL)` again to retrieve the
+ * path
+ * - add a terminal NUL character with `path[length] = '\0';`
+ *
+ * @param out destination buffer, optional
+ * @param capacity destination buffer capacity
+ * @param dirname_length optional recipient for the length of the dirname part
+ * of the path. Available only when `capacity` is large enough to retrieve the
+ * path.
+ *
+ * @return the length of the executable path on success (without a terminal NUL
+ * character), otherwise `-1`
+ */
+WAI_FUNCSPEC
+int WAI_PREFIX(getExecutablePath)(char* out, int capacity, int* dirname_length);
+
+/**
+ * Returns the path to the current module
+ *
+ * Usage:
+ * - first call `int length = wai_getModulePath(NULL, 0, NULL);` to retrieve
+ * the length of the path
+ * - allocate the destination buffer with `path = (char*)malloc(length + 1);`
+ * - call `wai_getModulePath(path, length, NULL)` again to retrieve the path
+ * - add a terminal NUL character with `path[length] = '\0';`
+ *
+ * @param out destination buffer, optional
+ * @param capacity destination buffer capacity
+ * @param dirname_length optional recipient for the length of the dirname part
+ * of the path. Available only when `capacity` is large enough to retrieve the
+ * path.
+ *
+ * @return the length of the module path on success (without a terminal NUL
+ * character), otherwise `-1`
+ */
+WAI_FUNCSPEC
+int WAI_PREFIX(getModulePath)(char* out, int capacity, int* dirname_length);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // #ifndef WHEREAMI_H
diff --git a/test/where_exec.adb b/test/where_exec.adb
new file mode 100644
index 0000000..a4ea73c
--- /dev/null
+++ b/test/where_exec.adb
@@ -0,0 +1,20 @@
+
+
+-- Programmed by Jedidiah Barber
+-- Released into the public domain
+
+
+with
+
+ Ada.Text_IO,
+ Here_I_Am;
+
+
+procedure Where_Exec is
+begin
+
+ Ada.Text_IO.Put_Line (Here_I_Am.Executable);
+
+end Where_Exec;
+
+
diff --git a/test/where_mod.adb b/test/where_mod.adb
new file mode 100644
index 0000000..d636e4f
--- /dev/null
+++ b/test/where_mod.adb
@@ -0,0 +1,20 @@
+
+
+-- Programmed by Jedidiah Barber
+-- Released into the public domain
+
+
+with
+
+ Ada.Text_IO,
+ Here_I_Am;
+
+
+procedure Where_Mod is
+begin
+
+ Ada.Text_IO.Put_Line (Here_I_Am.Module);
+
+end Where_Mod;
+
+
diff --git a/testlib.gpr b/testlib.gpr
new file mode 100644
index 0000000..406ade8
--- /dev/null
+++ b/testlib.gpr
@@ -0,0 +1,26 @@
+
+
+with
+
+ "proj/common";
+
+
+library project Testlib is
+
+
+ for Languages use ("Ada", "C");
+
+ for Source_Dirs use ("src");
+ for Object_Dir use "obj";
+ for Library_Dir use "lib";
+ for Library_Name use "test";
+ for Library_Kind use "dynamic";
+
+ package Builder renames Common.Builder;
+ package Compiler renames Common.Compiler;
+ package Binder renames Common.Binder;
+
+
+end Testlib;
+
+
diff --git a/tests.gpr b/tests.gpr
new file mode 100644
index 0000000..b291c3b
--- /dev/null
+++ b/tests.gpr
@@ -0,0 +1,39 @@
+
+
+with
+
+ "proj/common",
+ "testlib";
+
+
+project Tests is
+
+
+ for Languages use ("Ada");
+
+ for Source_Dirs use ("test");
+ for Object_Dir use "obj";
+ for Exec_Dir use "bin";
+
+ for Main use
+ ("where_exec.adb",
+ "where_mod.adb");
+
+ package Builder is
+ for Executable ("where_exec.adb") use "where_exec";
+ for Executable ("where_mod.adb") use "where_mod";
+
+ for Default_Switches ("Ada") use
+ Common.Builder'Default_Switches ("Ada");
+ for Global_Compilation_Switches ("Ada") use
+ Common.Builder'Global_Compilation_Switches ("Ada");
+ end Builder;
+
+ package Compiler renames Common.Compiler;
+ package Binder renames Common.Binder;
+ package Linker renames Common.Linker;
+
+
+end Tests;
+
+
diff --git a/unlicense.txt b/unlicense.txt
new file mode 100644
index 0000000..68a49da
--- /dev/null
+++ b/unlicense.txt
@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org/>