Page:
n__common_8c
Pages
Examples
Files
Home
Module AABB3D
Module ACCEPT_POOL
Module ALLEGRO4
Module ALLEGRO5
Module ANIM_LIB
Module ASTAR
Module ATLAS_LIB
Module AVRO
Module CLOCK_SYNC
Module COMMONS
Module CONFIGFILE
Module CYPHER_BASE64
Module CYPHER_VIGENERE
Module DEAD_RECKONING
Module ENUMS
Module EXCEPTIONS
Module GAME_ENV
Module GIT
Module GUI
Module HASH_TABLE
Module ISOMETRIC_ENGINE
Module LIST
Module LOG
Module LOGNODUP
Module LZ4
Module NETWORKING
Module NETWORK_MSG
Module N_COOKIES
Module N_DIFF
Module N_DIGEST
Module N_DISK_CACHE
Module N_DNS
Module N_ECC
Module N_ENTROPY
Module N_FILES
Module N_FLUIDS
Module N_GUI_COLOR
Module N_GUI_COLORWHEEL
Module N_GUI_CURVE
Module N_GUI_GRID
Module N_GUI_POPUP
Module N_HEX
Module N_HTTP3
Module N_HTTP_COOKIE
Module N_HTTP_FORM
Module N_HTTP_MIME
Module N_HTTP_REQ
Module N_HTTP_RESP
Module N_HTTP_ROUTER
Module N_HTTP_SERVER
Module N_ICC
Module N_JSON
Module N_KAFKA
Module N_LINALG
Module N_MODULE
Module N_OPENSSL_COMPAT
Module N_PRETTY
Module N_PTH
Module N_QUERY
Module N_RANDOM
Module N_SHA256
Module N_STR
Module N_TIFF
Module N_TIME
Module N_USER
Module N_X509
Module N_ZIP
Module PARTICLES
Module PCRE
Module PHYSICS
Module SIGNALS
Module STACK
Module THREADS
Module TRAJECTORY
Module TREE
Module ZLIB
Modules
Pages
Struct A4_BMP
Struct A4_TIMER
Struct AABB3D
Struct ANIM_DATA
Struct ANIM_FRAME
Struct ANIM_GFX
Struct ANIM_LIB
Struct ASTAR_BOX
Struct ASTAR_CELL
Struct ASTAR_GRID
Struct ASTAR_HEAP
Struct ASTAR_HEAP_NODE
Struct ASTAR_NODE
Struct ASTAR_PATH
Struct AVRO_FIELD
Struct AVRO_READER
Struct AVRO_SCHEMA
Struct BITMAP
Struct CALLBACK_DATA
Struct CA_CTX
Struct CLIENT_JOB
Struct CLIENT_STATE
Struct CONFIG_FILE
Struct CONFIG_FILE_SECTION
Struct CYPHER_PARAM
Struct DATA
Struct DEMO_PANEL
Struct DICTIONARY_DEFINITION
Struct DICTIONARY_ENTRY
Struct DIFF_OUT
Struct DIFF_TEXT
Struct DRAW_STATE
Struct DR_ENTITY
Struct DR_STATE
Struct DR_VEC3
Struct ExceptionContextList
Struct FONT
Struct GAME_ENV
Struct H2BUF
Struct H2_DYN_ENTRY
Struct H2_STREAM
Struct HASH_NODE
Struct HASH_TABLE
Struct ISO_DRAW_ENTRY
Struct ISO_MAP
Struct ISO_PROJECTION
Struct ISO_TILE_SEGMENT
Struct ISO_TILE_SEGMENTS
Struct ISO_VISIBLE_EDGES
Struct JS_STATE
Struct LEX_ITEM
Struct LIST
Struct LIST_NODE
Struct LOG_LEVELS
Struct LexMenu
Struct MEMBER
Struct MIDI
Struct NESTED
Struct NETWORK
Struct NETWORK_HTTP_INFO
Struct NETWORK_POOL
Struct NETWORK_SSL_THREAD_PARAMS
Struct NETW_ACCEPT_POOL
Struct NETW_ACCEPT_POOL_STATS
Struct NETW_MSG
Struct NETW_SNI_ARG
Struct NODE_DATA
Struct N_ATLAS
Struct N_ATLAS_PAGE
Struct N_CLOCK_SYNC
Struct N_COOKIE
Struct N_COOKIE_JAR
Struct N_DIFF_LINE
Struct N_DIFF_RESULT
Struct N_DISK_CACHE
Struct N_ENTROPY_BIT
Struct N_ENTROPY_POS
Struct N_FILE_INFO
Struct N_FLUID
Struct N_FLUID_THREAD_PARAMS
Struct N_FORM_FIELD
Struct N_GIT_COMMIT_INFO
Struct N_GIT_REMOTE_AUTH
Struct N_GIT_REPO
Struct N_GIT_STATUS_ENTRY
Struct N_GUI_BUTTON_DATA
Struct N_GUI_CHECKBOX_DATA
Struct N_GUI_COLOR_PICKER
Struct N_GUI_COMBOBOX_DATA
Struct N_GUI_CTX
Struct N_GUI_CUSTOM_DATA
Struct N_GUI_DATAGRID_COL
Struct N_GUI_DATAGRID_DATA
Struct N_GUI_DROPMENU_DATA
Struct N_GUI_DROPMENU_ENTRY
Struct N_GUI_GRID_CALLBACKS
Struct N_GUI_HEXVIEW_DATA
Struct N_GUI_IMAGE_DATA
Struct N_GUI_KVTABLE
Struct N_GUI_KV_CONTENT
Struct N_GUI_KV_ROW
Struct N_GUI_LABEL_DATA
Struct N_GUI_LISTBOX_DATA
Struct N_GUI_LISTITEM
Struct N_GUI_MARKDOWNVIEW_DATA
Struct N_GUI_MD_FONTS
Struct N_GUI_MD_STYLE
Struct N_GUI_MEAS_ENTRY
Struct N_GUI_MOUSE_EVENT
Struct N_GUI_PENDING_GEOM
Struct N_GUI_PENDING_WIDGET
Struct N_GUI_POPUP
Struct N_GUI_PROGRESSBAR_DATA
Struct N_GUI_RADIOLIST_DATA
Struct N_GUI_SB_TRACK
Struct N_GUI_SCROLLBAR_DATA
Struct N_GUI_SECTION
Struct N_GUI_SECTIONLIST
Struct N_GUI_SLIDER_DATA
Struct N_GUI_SPLITPANE_DATA
Struct N_GUI_STYLE
Struct N_GUI_SUGGEST_SINK
Struct N_GUI_SYNTAXVIEW_DATA
Struct N_GUI_TAB_PANEL
Struct N_GUI_TB_BUTTONS
Struct N_GUI_TEXTAREA_DATA
Struct N_GUI_TEXT_DIMS
Struct N_GUI_THEME
Struct N_GUI_TREE
Struct N_GUI_TREE_NODE
Struct N_GUI_TREE_STATE
Struct N_GUI_WIDGET
Struct N_GUI_WINDOW
Struct N_H2_FRAME
Struct N_H2_HEADER
Struct N_H2_HPACK
Struct N_H2_REQUEST
Struct N_H2_SERVER
Struct N_H2_SETTING
Struct N_HTML_ATTR_
Struct N_HTML_FORM
Struct N_HTML_TAG_
Struct N_HTTP3_RESPONSE
Struct N_HTTP_FIELD
Struct N_HTTP_FORM
Struct N_HTTP_FORM_MULTIPART
Struct N_HTTP_FORM_PART
Struct N_HTTP_MULTIPART_PART
Struct N_HTTP_REQUEST
Struct N_HTTP_RESP
Struct N_HTTP_RESPONSE
Struct N_HTTP_SERVER
Struct N_HTTP_SERVER_CONFIG
Struct N_HTTP_SERVER_REQUEST
Struct N_HTTP_SERVER_STATS
Struct N_HTTP_SET_COOKIE
Struct N_HTTP_STREAM
Struct N_ISO_CAMERA
Struct N_ISO_OBJECT
Struct N_KAFKA
Struct N_KAFKA_EVENT
Struct N_MOCK_SERVER
Struct N_MODULE
Struct N_PARALLEL_SLICE
Struct N_PARALLEL_TEAM
Struct N_PARALLEL_WORKER
Struct N_PCRE
Struct N_PROXY_CFG
Struct N_PTH
Struct N_PTH_TENSOR
Struct N_QUERY
Struct N_ROUTE
Struct N_ROUTER
Struct N_ROUTE_MATCH
Struct N_SHA256
Struct N_SOCKET
Struct N_SPAWN_PIPE
Struct N_SSE_CONN
Struct N_SSE_EVENT
Struct N_STR
Struct N_TIFF
Struct N_TIFF_ENTRY
Struct N_TIME
Struct N_URL
Struct N_URL_PARAM
Struct N_USER
Struct N_USERLIST
Struct N_WS_CONN
Struct N_WS_FRAME
Struct N_WS_MESSAGE
Struct N_ZIP_MEMBER
Struct OCTREE
Struct OCTREE_NODE
Struct PARSER
Struct PARTICLE
Struct PARTICLE_EMITTER
Struct PARTICLE_SYSTEM
Struct PEER
Struct PHYSICS
Struct PK_OBJ
Struct PK_VM
Struct POINT2D
Struct POINT3D
Struct PRETTY_OUT
Struct QNODE
Struct QUADTREE
Struct QUADTREE_NODE
Struct REC
Struct RGB
Struct SAMPLE
Struct SEEN
Struct SHARER
Struct SRV
Struct SRV_ARG
Struct STACK
Struct STACK_ITEM
Struct SYNTAX_RUN
Struct THREAD_POOL
Struct THREAD_POOL_NODE
Struct THREAD_WAITING_PROC
Struct TRAJECTORY
Struct TRAJECTORY_POINT
Struct TREE
Struct TREE_NODE
Struct TS_LOG
Struct WAYPOINT3D
Struct WORKER_ARG
Struct ZIP_SINK
Struct _N_DC_ENTRY
Struct _N_DC_GROUP_ENTRY
Struct _N_GUI_COLORWHEEL
Struct _N_GUI_COLORWHEEL_BLOCK
Struct _N_GUI_COLORWHEEL_MOUSE
Struct _N_GUI_CURVE
Struct _N_GUI_CURVE_BLOCK
Struct _N_GUI_CURVE_MOUSE
Struct _N_GUI_GRID
Struct _N_GUI_POPUP_ENTRY
Struct _N_GUI_POPUP_LEVEL
Struct _N_GUI_SB_SKIN
Struct _N_GUI_TA_STEP
Struct _N_GUI_THUMB
Struct _N_GUI_WRAP_ACC
Struct _compiled
Struct _conn
Struct _ip_slot
Struct _mp_param
Struct _n_civil
Struct _seg
Struct client
Struct collector
Struct date_vector
Struct md_atom
Struct md_cells
Struct md_hit
Struct md_line_ctx
Struct mline
Struct n_http_req_header
Struct n_http_req_limits
Struct n_http_request
Struct n_markdown_block
Struct n_markdown_doc
Struct n_markdown_inline
Struct n_markdown_span
Struct n_reactor_stats
Struct n_url_safe
Struct n_url_safe_head
Struct n_wrap_item
Struct producer_state
Struct rects
Struct reply
Struct runner
Struct sink
Struct tbuf
Struct wrap_hit
Struct wrap_span
Structures
Union COORD_VALUE
Union HASH_DATA
Union NODE_DATA_TYPES
Union STACK_DATA
dir_310dcdd4703e877a6b99d5dc3fc54d27
dir_68267d1309a1af8e8297ef4c3efbcdba
dir_d28a4824dc47e487b107a5db32ef43c4
dir_d44c64559bbebec7f509842c48db8b23
ex__accept__pool__client_8c
ex__accept__pool__server_8c
ex__allegro__4_8c
ex__atlas_8c
ex__avro_8c
ex__base64_8c
ex__bind__exclusive_8c
ex__clipboard_8c
ex__clock__sync_8c
ex__common_8c
ex__configfile_8c
ex__cookies_8c
ex__crypto_8c
ex__diff_8c
ex__digest_8c
ex__disk__cache_8c
ex__dns_8c
ex__ecc_8c
ex__entropy_8c
ex__exceptions_8c
ex__file_8c
ex__file__copy_8c
ex__fluid_8c
ex__fluid__config_8c
ex__fluid__config_8h
ex__git_8c
ex__gui_8c
ex__gui__bench_8c
ex__gui__button__keys_8c
ex__gui__checkbox__label_8c
ex__gui__checkbox__release_8c
ex__gui__color__picker_8c
ex__gui__colorwheel_8c
ex__gui__combobox__items_8c
ex__gui__combobox__wheel_8c
ex__gui__cursor_8c
ex__gui__curve_8c
ex__gui__custom_8c
ex__gui__custom__mouse_8c
ex__gui__datagrid_8c
ex__gui__datagrid__keys_8c
ex__gui__datagrid__sort_8c
ex__gui__detach_8c
ex__gui__dictionary_8c
ex__gui__display__fallback_8c
ex__gui__double__click_8c
ex__gui__dropmenu_8c
ex__gui__frameless__drag_8c
ex__gui__global__scroll_8c
ex__gui__glyph_8c
ex__gui__grid_8c
ex__gui__hexview_8c
ex__gui__hover_8c
ex__gui__isometric_8c
ex__gui__kvtable_8c
ex__gui__label__fits_8c
ex__gui__label__lines_8c
ex__gui__layout__persist_8c
ex__gui__listbox_8c
ex__gui__md_8c
ex__gui__multiwin_8c
ex__gui__network_8c
ex__gui__particles_8c
ex__gui__placeholder_8c
ex__gui__popup_8c
ex__gui__progressbar_8c
ex__gui__reentrant_8c
ex__gui__round_8c
ex__gui__sectionlist_8c
ex__gui__slider__default_8c
ex__gui__slider__handle_8c
ex__gui__slider__step_8c
ex__gui__splitpane_8c
ex__gui__suggest_8c
ex__gui__syntaxview_8c
ex__gui__text__shorten_8c
ex__gui__textarea__selection_8c
ex__gui__tooltip_8c
ex__gui__tree__lazy_8c
ex__gui__tree__order_8c
ex__gui__tree__state_8c
ex__gui__window__rect_8c
ex__gui__zorder_8c
ex__hash_8c
ex__hex_8c
ex__html_8c
ex__http2_8c
ex__http2__server_8c
ex__http3_8c
ex__http__cookie_8c
ex__http__form_8c
ex__http__mime_8c
ex__http__req_8c
ex__http__response_8c
ex__http__router_8c
ex__http__server_8c
ex__icc_8c
ex__iso__astar_8c
ex__json_8c
ex__kafka_8c
ex__linalg_8c
ex__list_8c
ex__log_8c
ex__markdown_8c
ex__module_8c
ex__monolith_8c
ex__network_8c
ex__network_8h
ex__network__accept_8c
ex__network__alpn_8c
ex__network__connect__abort_8c
ex__network__mock_8c
ex__network__proxy_8c
ex__network__reactor_8c
ex__network__sni_8c
ex__network__sse_8c
ex__network__ssl_8c
ex__network__ssl__hardened_8c
ex__network__ssl__hostname_8c
ex__network__ssl__nonblock_8c
ex__network__tls__defaults_8c
ex__network__ws_8c
ex__network__ws__limits_8c
ex__nstr_8c
ex__parallel__for_8c
ex__parallel__team_8c
ex__pcre_8c
ex__pretty_8c
ex__pth_8c
ex__query_8c
ex__random_8c
ex__sha256_8c
ex__signals_8c
ex__spawn_8c
ex__ssrf_8c
ex__stack_8c
ex__thread__pool__discard_8c
ex__thread__pool__wait_8c
ex__threads_8c
ex__tiff_8c
ex__time__formats_8c
ex__trajectory_8c
ex__trees_8c
ex__url_8c
ex__url__safe_8c
ex__wrap_8c
ex__x509_8c
ex__zip_8c
ex__zlib_8c
ex_accept_pool_client_8c example
ex_accept_pool_server_8c example
ex_allegro_4_8c example
ex_atlas_8c example
ex_base64_8c example
ex_clock_sync_8c example
ex_common_8c example
ex_configfile_8c example
ex_cookies_8c example
ex_crypto_8c example
ex_diff_8c example
ex_digest_8c example
ex_disk_cache_8c example
ex_dns_8c example
ex_ecc_8c example
ex_entropy_8c example
ex_exceptions_8c example
ex_file_8c example
ex_file_copy_8c example
ex_fluid_8c example
ex_fluid_config_8c example
ex_fluid_config_8h example
ex_git_8c example
ex_gui_8c example
ex_gui_bench_8c example
ex_gui_button_keys_8c example
ex_gui_checkbox_label_8c example
ex_gui_checkbox_release_8c example
ex_gui_color_picker_8c example
ex_gui_colorwheel_8c example
ex_gui_combobox_items_8c example
ex_gui_combobox_wheel_8c example
ex_gui_cursor_8c example
ex_gui_curve_8c example
ex_gui_custom_8c example
ex_gui_custom_mouse_8c example
ex_gui_datagrid_8c example
ex_gui_datagrid_keys_8c example
ex_gui_datagrid_sort_8c example
ex_gui_detach_8c example
ex_gui_dictionary_8c example
ex_gui_display_fallback_8c example
ex_gui_double_click_8c example
ex_gui_dropmenu_8c example
ex_gui_frameless_drag_8c example
ex_gui_global_scroll_8c example
ex_gui_glyph_8c example
ex_gui_grid_8c example
ex_gui_hexview_8c example
ex_gui_hover_8c example
ex_gui_isometric_8c example
ex_gui_kvtable_8c example
ex_gui_label_fits_8c example
ex_gui_label_lines_8c example
ex_gui_layout_persist_8c example
ex_gui_listbox_8c example
ex_gui_md_8c example
ex_gui_multiwin_8c example
ex_gui_network_8c example
ex_gui_particles_8c example
ex_gui_placeholder_8c example
ex_gui_popup_8c example
ex_gui_progressbar_8c example
ex_gui_reentrant_8c example
ex_gui_round_8c example
ex_gui_sectionlist_8c example
ex_gui_slider_default_8c example
ex_gui_slider_handle_8c example
ex_gui_slider_step_8c example
ex_gui_splitpane_8c example
ex_gui_suggest_8c example
ex_gui_syntaxview_8c example
ex_gui_text_shorten_8c example
ex_gui_textarea_selection_8c example
ex_gui_tooltip_8c example
ex_gui_tree_lazy_8c example
ex_gui_tree_order_8c example
ex_gui_tree_state_8c example
ex_gui_window_rect_8c example
ex_gui_zorder_8c example
ex_hash_8c example
ex_hex_8c example
ex_html_8c example
ex_http2_8c example
ex_http2_server_8c example
ex_http_cookie_8c example
ex_http_form_8c example
ex_http_mime_8c example
ex_http_req_8c example
ex_http_response_8c example
ex_http_router_8c example
ex_http_server_8c example
ex_icc_8c example
ex_iso_astar_8c example
ex_json_8c example
ex_kafka_8c example
ex_linalg_8c example
ex_list_8c example
ex_log_8c example
ex_markdown_8c example
ex_module_8c example
ex_monolith_8c example
ex_network_8c example
ex_network_8h example
ex_network_accept_8c example
ex_network_alpn_8c example
ex_network_connect_abort_8c example
ex_network_mock_8c example
ex_network_proxy_8c example
ex_network_reactor_8c example
ex_network_sni_8c example
ex_network_sse_8c example
ex_network_ssl_8c example
ex_network_ssl_hardened_8c example
ex_network_ssl_hostname_8c example
ex_network_ssl_nonblock_8c example
ex_network_tls_defaults_8c example
ex_network_ws_8c example
ex_network_ws_limits_8c example
ex_nstr_8c example
ex_parallel_for_8c example
ex_parallel_team_8c example
ex_pcre_8c example
ex_pretty_8c example
ex_pth_8c example
ex_query_8c example
ex_random_8c example
ex_sha256_8c example
ex_signals_8c example
ex_spawn_8c example
ex_ssrf_8c example
ex_stack_8c example
ex_threads_8c example
ex_tiff_8c example
ex_time_formats_8c example
ex_trajectory_8c example
ex_trees_8c example
ex_url_8c example
ex_url_safe_8c example
ex_wrap_8c example
ex_x509_8c example
ex_zip_8c example
ex_zlib_8c example
mainpage_8dox
n__3d_8c
n__3d_8h
n__aabb_8c
n__aabb_8h
n__allegro5_8c
n__allegro5_8h
n__allegro__4_8c
n__allegro__4_8h
n__anim_8c
n__anim_8h
n__astar_8c
n__astar_8h
n__atlas_8c
n__atlas_8h
n__avro_8c
n__avro_8h
n__base64_8c
n__base64_8h
n__clipboard_8c
n__clipboard_8h
n__clock__sync_8c
n__clock__sync_8h
n__common_8c
n__common_8h
n__config__file_8c
n__config__file_8h
n__cookies_8c
n__cookies_8h
n__crypto_8c
n__crypto_8h
n__dead__reckoning_8c
n__dead__reckoning_8h
n__diff_8c
n__diff_8h
n__digest_8c
n__digest_8h
n__disk__cache_8c
n__disk__cache_8h
n__dns_8c
n__dns_8h
n__ecc_8c
n__ecc_8h
n__entropy_8c
n__entropy_8h
n__enum_8h
n__exceptions_8c
n__exceptions_8h
n__files_8c
n__files_8h
n__fluids_8c
n__fluids_8h
n__games_8c
n__games_8h
n__git_8c
n__git_8h
n__gui_8c
n__gui_8h
n__gui__color_8c
n__gui__color_8h
n__gui__colorwheel_8c
n__gui__colorwheel_8h
n__gui__curve_8c
n__gui__curve_8h
n__gui__grid_8c
n__gui__grid_8h
n__gui__md_8c
n__gui__md_8h
n__gui__popup_8c
n__gui__popup_8h
n__hash_8c
n__hash_8h
n__hex_8c
n__hex_8h
n__html_8c
n__html_8h
n__http2_8c
n__http2_8h
n__http2__server_8c
n__http2__server_8h
n__http3_8c
n__http3_8h
n__http__cookie_8c
n__http__cookie_8h
n__http__form_8c
n__http__form_8h
n__http__mime_8c
n__http__mime_8h
n__http__req_8c
n__http__req_8h
n__http__response_8c
n__http__response_8h
n__http__router_8c
n__http__router_8h
n__http__server_8c
n__http__server_8h
n__icc_8c
n__icc_8h
n__iso__engine_8c
n__iso__engine_8h
n__json_8c
n__json_8h
n__kafka_8c
n__kafka_8h
n__linalg_8c
n__linalg_8h
n__list_8c
n__list_8h
n__log_8c
n__log_8h
n__lz4_8c
n__lz4_8h
n__markdown_8c
n__markdown_8h
n__module_8c
n__module_8h
n__network_8c
n__network_8h
n__network__accept__pool_8c
n__network__accept__pool_8h
n__network__msg_8c
n__network__msg_8h
n__nodup__log_8c
n__nodup__log_8h
n__openssl__compat_8h
n__particles_8c
n__particles_8h
n__pcre_8c
n__pcre_8h
n__pretty_8c
n__pretty_8h
n__pth_8c
n__pth_8h
n__query_8c
n__query_8h
n__random_8c
n__random_8h
n__reactor_8c
n__reactor_8h
n__sha256_8c
n__sha256_8h
n__signals_8c
n__signals_8h
n__ssrf_8c
n__ssrf_8h
n__stack_8c
n__stack_8h
n__str_8c
n__str_8h
n__thread__pool_8c
n__thread__pool_8h
n__tiff_8c
n__tiff_8h
n__time_8c
n__time_8h
n__trajectory_8c
n__trajectory_8h
n__trees_8c
n__trees_8h
n__url__safe_8c
n__url__safe_8h
n__user_8c
n__user_8h
n__windows_8h
n__wrap_8c
n__wrap_8h
n__x509_8c
n__x509_8h
n__zip_8c
n__zip_8h
n__zlib_8c
n__zlib_8h
nilorea_8h
No results
9
n__common_8c
gullradriel edited this page 2026-10-29 20:54:40 +01:00
src/n_common.c
Common function. More...
Structures
| Name | |
|---|---|
| struct | N_SPAWN_PIPE A program started with its standard input on a pipe the caller writes to (n_spawn_pipe_open()), or its standard output on one the caller reads (n_spawn_pipe_open_read()). |
Functions
| Name | |
|---|---|
| N_SPAWN_PIPE * | _n_spawn_pipe_start(const char * program, const char *const * args, const char * log_path, int reading) Start a program with one of its standard streams on a pipe. |
Detailed Description
Common function.
Author: Castagnier Mickael
Version: 1.0
Date: 24/03/05
Functions Documentation
function _n_spawn_pipe_start
static N_SPAWN_PIPE * _n_spawn_pipe_start(
const char * program,
const char *const * args,
const char * log_path,
int reading
)
Start a program with one of its standard streams on a pipe.
Parameters:
- program Program to run.
- args Its arguments, NULL terminated, or NULL.
- log_path Where what it says goes, or NULL to leave it.
- reading Non-zero for the reading form.
Return: The running program, or NULL.
The body of n_spawn_pipe_open() and n_spawn_pipe_open_read(). Writing, the pipe is the program's standard input and log_path takes its output and error. Reading, the pipe is its standard output, log_path takes its error alone - what it says must not be mixed into what it produces - and its input is the null device, so that it never waits on a terminal. The caller's end is never inherited by another program.
Source code
/*
* Nilorea Library
* Copyright (C) 2005-2026 Castagnier Mickael
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
* implied. See the License for the specific language governing
* permissions and limitations under the License.
*
* SPDX-License-Identifier: Apache-2.0
*/
#include "nilorea/n_common.h"
#include "nilorea/n_log.h"
#include "nilorea/n_str.h"
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <libgen.h>
#include "nilorea/n_windows.h"
#include <errno.h>
#include <strings.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#ifndef __windows__
#include <sys/wait.h>
#include <time.h>
#include <pthread.h>
#else
/* ShellExecuteA, which windows.h leaves out under WIN32_LEAN_AND_MEAN. */
#include <shellapi.h>
#endif
void n_abort(char const* format, ...) {
char str[1024] = "";
va_list args;
va_start(args, format);
vsnprintf(str, sizeof str, format, args);
va_end(args);
fprintf(stderr, "%s", str);
exit(1);
}
int get_computer_name(char* computer_name, size_t len) {
if (!computer_name || len == 0) return FALSE;
memset(computer_name, 0, len);
#ifdef WIN32
TCHAR infoBuf[len];
DWORD bufCharCount = (DWORD)len;
if (GetComputerName(infoBuf, &bufCharCount)) {
memcpy(computer_name, infoBuf, len);
} else {
strncpy(computer_name, "Unknown_Host_Name", len - 1);
computer_name[len - 1] = '\0';
return FALSE;
}
#else
if (gethostname(computer_name, len) == -1) {
int error = errno;
strncpy(computer_name, "Unknown_Host_Name", len - 1);
computer_name[len - 1] = '\0';
n_log(LOG_ERR, "%s on gethostname !", strerror(error));
return FALSE;
}
#endif
return TRUE;
} /* get_computer_name */
int file_exist(const char* filename) {
FILE* file = NULL;
if ((file = fopen(filename, "r")) != NULL) {
fclose(file);
return 1;
}
return 0;
} /* file_exist */
char* get_prog_dir(void) {
char strbuf[PATH_MAX] = "";
int error = 0;
#ifdef __windows__
unsigned long int bytes = GetModuleFileName(NULL, strbuf, PATH_MAX);
error = errno;
if (bytes != 0) {
return strdup(dirname(strbuf));
}
#else
char procbuf[PATH_MAX] = "";
#ifdef __linux__
snprintf(procbuf, PATH_MAX, "/proc/%d/exe", (int)getpid());
#elif defined __sun
snprintf(procbuf, PATH_MAX, "/proc/%d/path/a.out", (int)getpid());
#endif
ssize_t bytes = MIN(readlink(procbuf, strbuf, PATH_MAX), PATH_MAX - 1);
error = errno;
if (bytes >= 0) {
strbuf[bytes] = '\0';
return strdup(dirname(strbuf));
}
#endif
fprintf(stderr, "%s", strerror(error));
return NULL;
} /* get_prog_dir */
char* get_prog_name(void) {
char strbuf[PATH_MAX] = "";
int error = 0;
#ifdef __windows__
unsigned long int bytes = GetModuleFileName(NULL, strbuf, PATH_MAX);
error = errno;
if (bytes != 0) {
return strdup(basename(strbuf));
}
#else
char procbuf[PATH_MAX] = "";
#ifdef __linux__
snprintf(procbuf, PATH_MAX, "/proc/%d/exe", (int)getpid());
#elif defined __sun
snprintf(procbuf, PATH_MAX, "/proc/%d/path/a.out", (int)getpid());
#endif
ssize_t bytes = MIN(readlink(procbuf, strbuf, PATH_MAX), PATH_MAX - 1);
error = errno;
if (bytes >= 0) {
strbuf[bytes] = '\0';
return strdup(basename(strbuf));
}
#endif
fprintf(stderr, "%s", strerror(error));
return NULL;
} /* get_prog_name */
int n_popen(char* cmd, size_t read_buf_size, void** nstr_output, int* ret) {
__n_assert(cmd, return FALSE);
if (read_buf_size > INT_MAX) {
n_log(LOG_ERR, "read_buf_size buffer size is too large for fgets (%zu>%d)", read_buf_size, INT_MAX);
return FALSE;
}
if (read_buf_size > 65536) {
n_log(LOG_ERR, "read_buf_size %zu exceeds safe stack limit", read_buf_size);
return FALSE;
}
N_STR* output_pointer = new_nstr(read_buf_size + 1);
FILE* fp = NULL;
int status = 0;
char read_buf[read_buf_size];
fp = popen(cmd, "r");
int err = errno;
if (fp == NULL) {
n_log(LOG_ERR, "popen( %s ) returned NULL , %s (%d)", cmd, strerror(err), err);
free_nstr(&output_pointer);
return FALSE;
}
while (fgets(read_buf, (int)read_buf_size, fp) != NULL) {
size_t length = strlen(read_buf);
if (length > 0 && read_buf[length - 1] == '\n') {
read_buf[length - 1] = '\0';
}
nstrprintf_cat(output_pointer, "%s", read_buf);
}
status = pclose(fp);
err = errno;
if (status == -1) {
n_log(LOG_ERR, "pclose( %s ) returned -1 , %s (%d)", cmd, strerror(err), err);
free_nstr(&output_pointer);
return FALSE;
}
if (ret) (*ret) = WEXITSTATUS(status);
if (nstr_output) {
(*nstr_output) = output_pointer;
} else {
free_nstr(&output_pointer);
}
return TRUE;
} /* n_popen( ... ) */
#ifdef __windows__
static int append_quoted(char* out, size_t out_len, size_t* used, const char* arg) {
size_t slashes = 0;
const char* p = NULL;
#define N_PUT(c) \
do { \
if (*used + 1 >= out_len) \
return FALSE; \
out[(*used)++] = (c); \
} while (0)
if (*used)
N_PUT(' ');
N_PUT('"');
for (p = arg; *p; p++) {
if (*p == '\\') {
slashes++;
continue;
}
if (*p == '"') {
size_t k = 0;
for (k = 0; k < slashes * 2 + 1; k++)
N_PUT('\\');
} else {
size_t k = 0;
for (k = 0; k < slashes; k++)
N_PUT('\\');
}
slashes = 0;
N_PUT(*p);
}
{
size_t k = 0;
for (k = 0; k < slashes * 2; k++)
N_PUT('\\');
}
N_PUT('"');
out[*used] = '\0';
#undef N_PUT
return TRUE;
}
#endif
int n_spawn_detached(const char* program, const char* const* args) {
__n_assert(program, return FALSE);
#ifdef __windows__
{
char line[32768];
size_t used = 0;
STARTUPINFOA si;
PROCESS_INFORMATION pi;
size_t i = 0;
line[0] = '\0';
if (!append_quoted(line, sizeof(line), &used, program))
return FALSE;
for (i = 0; args && args[i]; i++) {
if (!append_quoted(line, sizeof(line), &used, args[i])) {
n_log(LOG_ERR, "n_spawn_detached: the command line is too long");
return FALSE;
}
}
memset(&si, 0, sizeof(si));
si.cb = sizeof(si);
memset(&pi, 0, sizeof(pi));
if (!CreateProcessA(NULL, line, NULL, NULL, FALSE, DETACHED_PROCESS | CREATE_NEW_PROCESS_GROUP,
NULL, NULL, &si, &pi)) {
n_log(LOG_ERR, "n_spawn_detached: cannot start %s (%lu)", program, (unsigned long)GetLastError());
return FALSE;
}
CloseHandle(pi.hThread);
CloseHandle(pi.hProcess);
return TRUE;
}
#else
{
const char* argv[64];
size_t i = 0, n = 0;
pid_t child = 0;
int status = 0;
argv[n++] = program;
for (i = 0; args && args[i]; i++) {
if (n >= sizeof(argv) / sizeof(argv[0]) - 1) {
n_log(LOG_ERR, "n_spawn_detached: more than %zu arguments", sizeof(argv) / sizeof(argv[0]) - 2);
return FALSE;
}
argv[n++] = args[i];
}
argv[n] = NULL;
/* Twice: the first child starts a session and forks the program,
* then leaves at once, so the program is adopted by init and never
* waits as a zombie on a caller that will not reap it. Only calls
* that are safe after a fork in a threaded process are made there. */
child = fork();
if (child < 0) {
n_log(LOG_ERR, "n_spawn_detached: fork failed: %s", strerror(errno));
return FALSE;
}
if (child == 0) {
pid_t grandchild = 0;
setsid();
grandchild = fork();
if (grandchild == 0) {
execvp(program, (char* const*)argv);
_exit(127);
}
_exit(grandchild < 0 ? 1 : 0);
}
if (waitpid(child, &status, 0) < 0 || !WIFEXITED(status) || WEXITSTATUS(status) != 0) {
n_log(LOG_ERR, "n_spawn_detached: could not start %s", program);
return FALSE;
}
return TRUE;
}
#endif
}
int n_spawn_wait(const char* program, const char* const* args, int* exit_code) {
return n_spawn_wait_cancel(program, args, exit_code, NULL);
}
int n_spawn_wait_cancel(const char* program, const char* const* args, int* exit_code, const volatile int* cancel) {
if (exit_code)
*exit_code = -1;
__n_assert(program, return FALSE);
#ifdef __windows__
{
char line[32768];
size_t used = 0;
STARTUPINFOA si;
PROCESS_INFORMATION pi;
DWORD code = 0;
size_t i = 0;
line[0] = '\0';
if (!append_quoted(line, sizeof(line), &used, program))
return FALSE;
for (i = 0; args && args[i]; i++) {
if (!append_quoted(line, sizeof(line), &used, args[i])) {
n_log(LOG_ERR, "n_spawn_wait: the command line is too long");
return FALSE;
}
}
memset(&si, 0, sizeof(si));
si.cb = sizeof(si);
memset(&pi, 0, sizeof(pi));
/* No console window for a tool run in the background. */
if (!CreateProcessA(NULL, line, NULL, NULL, FALSE, CREATE_NO_WINDOW, NULL, NULL, &si, &pi)) {
n_log(LOG_ERR, "n_spawn_wait: cannot start %s (%lu)", program, (unsigned long)GetLastError());
return FALSE;
}
CloseHandle(pi.hThread);
if (!cancel) {
WaitForSingleObject(pi.hProcess, INFINITE);
} else {
/* A tenth of a second between looks at the flag: short enough
* that a Stop is felt at once, long enough to cost nothing. */
while (WaitForSingleObject(pi.hProcess, 100) == WAIT_TIMEOUT) {
if (*cancel) {
TerminateProcess(pi.hProcess, 1);
WaitForSingleObject(pi.hProcess, INFINITE);
CloseHandle(pi.hProcess);
n_log(LOG_NOTICE, "n_spawn_wait_cancel: %s stopped", program);
return FALSE;
}
}
}
if (!GetExitCodeProcess(pi.hProcess, &code))
code = (DWORD)-1;
CloseHandle(pi.hProcess);
if (exit_code)
*exit_code = (int)code;
return code == 0 ? TRUE : FALSE;
}
#else
{
const char* argv[64];
size_t i = 0, n = 0;
pid_t child = 0;
int status = 0;
argv[n++] = program;
for (i = 0; args && args[i]; i++) {
if (n >= sizeof(argv) / sizeof(argv[0]) - 1) {
n_log(LOG_ERR, "n_spawn_wait: more than %zu arguments", sizeof(argv) / sizeof(argv[0]) - 2);
return FALSE;
}
argv[n++] = args[i];
}
argv[n] = NULL;
child = fork();
if (child < 0) {
n_log(LOG_ERR, "n_spawn_wait: fork failed: %s", strerror(errno));
return FALSE;
}
if (child == 0) {
/* Only calls that are safe after a fork in a threaded process. */
execvp(program, (char* const*)argv);
_exit(127);
}
if (cancel) {
/* Looked at every tenth of a second while the child runs. A
* stop asks it to end, gives it two seconds to write nothing
* more, then ends it, and reaps it either way so no zombie is
* left behind. */
int asked = 0;
for (;;) {
struct timespec tick = {0, 100000000L};
pid_t got = waitpid(child, &status, WNOHANG);
if (got == child)
break;
if (got < 0 && errno != EINTR) {
n_log(LOG_ERR, "n_spawn_wait_cancel: waiting for %s failed: %s", program, strerror(errno));
return FALSE;
}
if (*cancel) {
if (asked == 0)
kill(child, SIGTERM);
else if (asked == 20)
kill(child, SIGKILL);
asked++;
}
nanosleep(&tick, NULL);
}
if (asked) {
n_log(LOG_NOTICE, "n_spawn_wait_cancel: %s stopped", program);
return FALSE;
}
} else {
/* Retried on EINTR: a signal for another thread must not abandon
* a child that is still running. */
while (waitpid(child, &status, 0) < 0) {
if (errno != EINTR) {
n_log(LOG_ERR, "n_spawn_wait: waiting for %s failed: %s", program, strerror(errno));
return FALSE;
}
}
}
if (!WIFEXITED(status)) {
n_log(LOG_ERR, "n_spawn_wait: %s was ended by a signal", program);
return FALSE;
}
if (exit_code)
*exit_code = WEXITSTATUS(status);
if (WEXITSTATUS(status) == 127)
n_log(LOG_ERR, "n_spawn_wait: %s could not be found or started", program);
return WEXITSTATUS(status) == 0 ? TRUE : FALSE;
}
#endif
}
struct N_SPAWN_PIPE {
#ifdef __windows__
HANDLE end;
HANDLE process;
#else
int end;
pid_t child;
#endif
int reading;
char program[256];
};
static N_SPAWN_PIPE* _n_spawn_pipe_start(const char* program, const char* const* args, const char* log_path, int reading) {
N_SPAWN_PIPE* sp = NULL;
const char* who = reading ? "n_spawn_pipe_open_read" : "n_spawn_pipe_open";
__n_assert(program, return NULL);
Malloc(sp, N_SPAWN_PIPE, 1);
__n_assert(sp, return NULL);
snprintf(sp->program, sizeof(sp->program), "%s", program);
sp->reading = reading ? 1 : 0;
#ifdef __windows__
{
char line[32768];
size_t used = 0, i = 0;
STARTUPINFOA si;
PROCESS_INFORMATION pi;
SECURITY_ATTRIBUTES sa;
HANDLE read_end = NULL, write_end = NULL, child_end = NULL, log = INVALID_HANDLE_VALUE, nul = INVALID_HANDLE_VALUE;
line[0] = '\0';
if (!append_quoted(line, sizeof(line), &used, program)) {
Free(sp);
return NULL;
}
for (i = 0; args && args[i]; i++) {
if (!append_quoted(line, sizeof(line), &used, args[i])) {
n_log(LOG_ERR, "%s: the command line is too long", who);
Free(sp);
return NULL;
}
}
memset(&sa, 0, sizeof(sa));
sa.nLength = sizeof(sa);
sa.bInheritHandle = TRUE;
if (!CreatePipe(&read_end, &write_end, &sa, 0)) {
n_log(LOG_ERR, "%s: no pipe (%lu)", who, (unsigned long)GetLastError());
Free(sp);
return NULL;
}
/* Only the program's end is inherited: an inherited copy of ours
* would hold the pipe open after we close it. */
sp->end = reading ? read_end : write_end;
child_end = reading ? write_end : read_end;
SetHandleInformation(sp->end, HANDLE_FLAG_INHERIT, 0);
if (log_path) {
log = CreateFileA(log_path, GENERIC_WRITE, FILE_SHARE_READ, &sa, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
if (log == INVALID_HANDLE_VALUE)
n_log(LOG_ERR, "%s: cannot write %s (%lu)", who, log_path, (unsigned long)GetLastError());
}
if (reading)
nul = CreateFileA("NUL", GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, &sa, OPEN_EXISTING, 0, NULL);
memset(&si, 0, sizeof(si));
si.cb = sizeof(si);
si.dwFlags = STARTF_USESTDHANDLES;
if (reading) {
si.hStdInput = nul != INVALID_HANDLE_VALUE ? nul : GetStdHandle(STD_INPUT_HANDLE);
si.hStdOutput = child_end;
si.hStdError = log != INVALID_HANDLE_VALUE ? log : GetStdHandle(STD_ERROR_HANDLE);
} else {
si.hStdInput = child_end;
si.hStdOutput = log != INVALID_HANDLE_VALUE ? log : GetStdHandle(STD_OUTPUT_HANDLE);
si.hStdError = log != INVALID_HANDLE_VALUE ? log : GetStdHandle(STD_ERROR_HANDLE);
}
memset(&pi, 0, sizeof(pi));
if (!CreateProcessA(NULL, line, NULL, NULL, TRUE, CREATE_NO_WINDOW, NULL, NULL, &si, &pi)) {
n_log(LOG_ERR, "%s: cannot start %s (%lu)", who, program, (unsigned long)GetLastError());
CloseHandle(read_end);
CloseHandle(write_end);
if (log != INVALID_HANDLE_VALUE)
CloseHandle(log);
if (nul != INVALID_HANDLE_VALUE)
CloseHandle(nul);
Free(sp);
return NULL;
}
/* The program holds its own copies now. */
CloseHandle(child_end);
if (log != INVALID_HANDLE_VALUE)
CloseHandle(log);
if (nul != INVALID_HANDLE_VALUE)
CloseHandle(nul);
CloseHandle(pi.hThread);
sp->process = pi.hProcess;
return sp;
}
#else
{
const char* argv[64];
size_t i = 0, n = 0;
int fds[2] = {-1, -1};
int log = -1, nul = -1;
int mine = 0, theirs = 0;
argv[n++] = program;
for (i = 0; args && args[i]; i++) {
if (n >= sizeof(argv) / sizeof(argv[0]) - 1) {
n_log(LOG_ERR, "%s: more than %zu arguments", who, sizeof(argv) / sizeof(argv[0]) - 2);
Free(sp);
return NULL;
}
argv[n++] = args[i];
}
argv[n] = NULL;
if (pipe(fds) != 0) {
n_log(LOG_ERR, "%s: no pipe: %s", who, strerror(errno));
Free(sp);
return NULL;
}
/* Both ends close in every program started from here on, this one
* included; dup2 in the child makes the copy it keeps. */
fcntl(fds[1], F_SETFD, FD_CLOEXEC);
fcntl(fds[0], F_SETFD, FD_CLOEXEC);
mine = reading ? fds[0] : fds[1];
theirs = reading ? fds[1] : fds[0];
if (log_path) {
log = open(log_path, O_WRONLY | O_CREAT | O_TRUNC | O_CLOEXEC, 0644);
if (log < 0)
n_log(LOG_ERR, "%s: cannot write %s: %s", who, log_path, strerror(errno));
}
if (reading)
nul = open("/dev/null", O_RDONLY | O_CLOEXEC);
sp->child = fork();
if (sp->child < 0) {
n_log(LOG_ERR, "%s: fork failed: %s", who, strerror(errno));
close(fds[0]);
close(fds[1]);
if (log >= 0)
close(log);
if (nul >= 0)
close(nul);
Free(sp);
return NULL;
}
if (sp->child == 0) {
/* Only calls that are safe after a fork in a threaded process.
* dup2 clears close-on-exec on the copies it makes. */
if (reading) {
if (dup2(theirs, STDOUT_FILENO) < 0)
_exit(127);
if (nul >= 0)
dup2(nul, STDIN_FILENO);
if (log >= 0)
dup2(log, STDERR_FILENO);
} else {
if (dup2(theirs, STDIN_FILENO) < 0)
_exit(127);
if (log >= 0) {
dup2(log, STDOUT_FILENO);
dup2(log, STDERR_FILENO);
}
}
execvp(program, (char* const*)argv);
_exit(127);
}
close(theirs);
if (log >= 0)
close(log);
if (nul >= 0)
close(nul);
sp->end = mine;
return sp;
}
#endif
}
N_SPAWN_PIPE* n_spawn_pipe_open(const char* program, const char* const* args, const char* log_path) {
return _n_spawn_pipe_start(program, args, log_path, 0);
}
N_SPAWN_PIPE* n_spawn_pipe_open_read(const char* program, const char* const* args, const char* log_path) {
return _n_spawn_pipe_start(program, args, log_path, 1);
}
size_t n_spawn_pipe_read(N_SPAWN_PIPE* sp, void* data, size_t len) {
char* at = (char*)data;
size_t got = 0;
__n_assert(sp, return SIZE_MAX);
if (!sp->reading) {
n_log(LOG_ERR, "n_spawn_pipe_read: %s was started to be written to", sp->program);
return SIZE_MAX;
}
if (len && !data)
return SIZE_MAX;
#ifdef __windows__
if (!sp->end)
return SIZE_MAX;
while (got < len) {
DWORD chunk = (len - got) > 0x40000000u ? 0x40000000u : (DWORD)(len - got), read = 0;
if (!ReadFile(sp->end, at + got, chunk, &read, NULL) || read == 0) {
/* The writer gone is the end of the output, not an error. */
if (GetLastError() == ERROR_BROKEN_PIPE || read == 0)
break;
n_log(LOG_ERR, "n_spawn_pipe_read: reading %s failed (%lu)", sp->program, (unsigned long)GetLastError());
return SIZE_MAX;
}
got += read;
}
return got;
#else
if (sp->end < 0)
return SIZE_MAX;
while (got < len) {
ssize_t r = read(sp->end, at + got, len - got);
if (r < 0) {
if (errno == EINTR)
continue;
n_log(LOG_ERR, "n_spawn_pipe_read: reading %s failed: %s", sp->program, strerror(errno));
return SIZE_MAX;
}
if (r == 0)
break;
got += (size_t)r;
}
return got;
#endif
}
int n_spawn_pipe_write(N_SPAWN_PIPE* sp, const void* data, size_t len) {
const char* at = (const char*)data;
__n_assert(sp, return FALSE);
if (sp->reading) {
n_log(LOG_ERR, "n_spawn_pipe_write: %s was started to be read from", sp->program);
return FALSE;
}
if (len && !data)
return FALSE;
#ifdef __windows__
if (!sp->end)
return FALSE;
while (len) {
DWORD chunk = len > 0x40000000u ? 0x40000000u : (DWORD)len, wrote = 0;
if (!WriteFile(sp->end, at, chunk, &wrote, NULL) || wrote == 0) {
n_log(LOG_ERR, "n_spawn_pipe_write: %s stopped reading (%lu)", sp->program, (unsigned long)GetLastError());
return FALSE;
}
at += wrote;
len -= wrote;
}
return TRUE;
#else
{
sigset_t pipe_set, before;
int ok = TRUE, raised = 0;
if (sp->end < 0)
return FALSE;
/* A program that has gone sends SIGPIPE to the writer, whose default
* is to end the whole caller. Held back for this thread only, which
* leaves the rest of the process's handling alone, and taken off the
* pending set afterwards if it came. */
sigemptyset(&pipe_set);
sigaddset(&pipe_set, SIGPIPE);
pthread_sigmask(SIG_BLOCK, &pipe_set, &before);
while (len) {
ssize_t wrote = write(sp->end, at, len);
if (wrote < 0) {
if (errno == EINTR)
continue;
if (errno == EPIPE)
raised = 1;
n_log(LOG_ERR, "n_spawn_pipe_write: %s stopped reading: %s", sp->program, strerror(errno));
ok = FALSE;
break;
}
at += wrote;
len -= (size_t)wrote;
}
if (raised) {
struct timespec none = {0, 0};
while (sigtimedwait(&pipe_set, NULL, &none) < 0 && errno == EINTR);
}
pthread_sigmask(SIG_SETMASK, &before, NULL);
return ok;
}
#endif
}
int n_spawn_pipe_close(N_SPAWN_PIPE** pipe_ptr, int stop, int* exit_code) {
N_SPAWN_PIPE* sp = NULL;
int ok = FALSE;
if (exit_code)
*exit_code = -1;
if (!pipe_ptr || !*pipe_ptr)
return FALSE;
sp = *pipe_ptr;
#ifdef __windows__
{
DWORD code = (DWORD)-1;
if (stop)
TerminateProcess(sp->process, 1);
/* Closing our end is the end of the stream a reading program waits
* for, and a broken pipe for a writing one, which ends it. */
if (sp->end)
CloseHandle(sp->end);
WaitForSingleObject(sp->process, INFINITE);
if (!stop && GetExitCodeProcess(sp->process, &code)) {
if (exit_code)
*exit_code = (int)code;
ok = code == 0 ? TRUE : FALSE;
}
CloseHandle(sp->process);
}
#else
{
int status = 0, asked = 0;
if (stop)
kill(sp->child, SIGTERM);
/* Closing our end is the end of the stream a reading program waits
* for, and a broken pipe for a writing one, which ends it. */
if (sp->end >= 0)
close(sp->end);
sp->end = -1;
for (;;) {
pid_t got = waitpid(sp->child, &status, stop ? WNOHANG : 0);
if (got == sp->child)
break;
if (got < 0) {
if (errno == EINTR)
continue;
n_log(LOG_ERR, "n_spawn_pipe_close: waiting for %s failed: %s", sp->program, strerror(errno));
Free(sp);
*pipe_ptr = NULL;
return FALSE;
}
/* Stopping: two seconds of grace, then the end. */
if (++asked == 20)
kill(sp->child, SIGKILL);
{
struct timespec tick = {0, 100000000L};
nanosleep(&tick, NULL);
}
}
if (stop) {
n_log(LOG_NOTICE, "n_spawn_pipe_close: %s stopped", sp->program);
} else if (!WIFEXITED(status)) {
n_log(LOG_ERR, "n_spawn_pipe_close: %s was ended by a signal", sp->program);
} else {
if (exit_code)
*exit_code = WEXITSTATUS(status);
if (WEXITSTATUS(status) == 127)
n_log(LOG_ERR, "n_spawn_pipe_close: %s could not be found or started", sp->program);
ok = WEXITSTATUS(status) == 0 ? TRUE : FALSE;
}
}
#endif
Free(sp);
*pipe_ptr = NULL;
return ok;
}
int n_open_with_default(const char* path) {
__n_assert(path, return FALSE);
#ifdef __windows__
{
HINSTANCE done = ShellExecuteA(NULL, "open", path, NULL, NULL, SW_SHOWNORMAL);
/* ShellExecute reports success as a value above 32. */
if ((INT_PTR)done <= 32) {
n_log(LOG_ERR, "n_open_with_default: cannot open %s (%ld)", path, (long)(INT_PTR)done);
return FALSE;
}
return TRUE;
}
#else
{
const char* args[2] = {path, NULL};
#ifdef __APPLE__
return n_spawn_detached("open", args);
#else
return n_spawn_detached("xdg-open", args);
#endif
}
#endif
}
void log_environment(int loglevel) {
#if defined(_WIN32) || defined(__MINGW32__) || defined(__windows__)
LPCH env_block = GetEnvironmentStrings();
if (!env_block) return;
for (LPCH var = env_block; *var != '\0'; var += strlen(var) + 1) {
n_log(loglevel, "env: %s", var);
}
FreeEnvironmentStrings(env_block);
#else
extern char** environ;
for (char** env = environ; *env != NULL; env++) {
n_log(loglevel, "env: %s", *env);
}
#endif
}
#ifndef __windows__
void sigchld_handler(int sig) {
// waitpid() might overwrite errno, so we save and restore it:
int saved_errno = errno;
while (waitpid(-1, NULL, WNOHANG) > 0);
errno = saved_errno;
n_log(LOG_DEBUG, "Signal %d", sig);
}
int sigchld_handler_installer(void) {
struct sigaction sa;
sa.sa_handler = sigchld_handler; // reap all dead processes
sigemptyset(&sa.sa_mask);
sa.sa_flags = SA_RESTART;
if (sigaction(SIGCHLD, &sa, NULL) == -1) {
int error = errno;
n_log(LOG_ERR, "sigaction error: %s", strerror(error));
return FALSE;
}
return TRUE;
}
int n_daemonize(void) {
return n_daemonize_ex(N_DAEMON_NO_SIGCHLD_IGN | N_DAEMON_NO_SIGCHLD_HANDLER);
}
int n_daemonize_ex(int mode) {
int error = 0;
/* Fork off the parent process */
pid_t pid = fork();
error = errno;
if (pid < 0) {
n_log(LOG_ERR, "Error: unable to fork child: %s", strerror(error));
exit(1);
}
if (pid > 0) {
n_log(LOG_NOTICE, "Child started successfuly !");
exit(0);
}
if (!(mode & N_DAEMON_NO_SETSID)) {
/* On success: The child process becomes session leader
* setsid is detaching the process from the terminal */
if (setsid() < 0) {
error = errno;
n_log(LOG_ERR, "Error: unable to set session leader with setsid(): %s", strerror(error));
exit(1);
} else {
n_log(LOG_NOTICE, "Session leader set !");
}
}
if (!(mode & N_DAEMON_NO_SIGCHLD_IGN)) {
/* Ignore signal sent from child to parent process */
signal(SIGCHLD, SIG_IGN);
}
if (!(mode & N_DAEMON_NO_SIGCHLD_HANDLER)) {
/* catching signal */
sigchld_handler_installer();
}
if (!(mode & N_DAEMON_NO_DOUBLE_FORK)) {
/* Double fork to detach from the parent, and be adopted by init process */
pid = fork();
error = errno;
if (pid < 0) {
n_log(LOG_ERR, "Error: unable to double fork child: %s", strerror(error));
exit(1);
}
if (pid > 0) {
n_log(LOG_NOTICE, "Double fork child started successfuly !");
exit(0);
}
}
if (!(mode & N_DAEMON_NO_UMASK)) {
/* reset umask */
umask(0);
}
if (!(mode & N_DAEMON_NO_CHDIR)) {
/* set working directory */
if (chdir("/") < 0) {
error = errno;
n_log(LOG_ERR, "couldn't chdir() to '/': %s", strerror(error));
return FALSE;
}
}
if (!(mode & N_DAEMON_NO_CLOSE)) {
/* Close all open file descriptors except standard ones (stdin, stdout, stderr) */
for (int x = 3; x < sysconf(_SC_OPEN_MAX); x++) {
close(x);
}
}
if (!(mode & N_DAEMON_NO_STD_REDIRECT)) {
/* redirect stdin,stdout,stderr to /dev/null */
int fd = open("/dev/null", O_RDWR, 0);
if (fd != -1) {
dup2(fd, STDIN_FILENO);
dup2(fd, STDOUT_FILENO);
dup2(fd, STDERR_FILENO);
if (fd > 2) {
close(fd);
}
} else {
n_log(LOG_ERR, "Failed to open /dev/null: %s", strerror(errno));
}
}
return TRUE;
} /* n_daemonize(...) */
pid_t system_nb(const char* command, int* infp, int* outfp) {
__n_assert(command, return -1);
int p_stdin[2] = {-1, -1};
int p_stdout[2] = {-1, -1};
pid_t pid = -1;
if (outfp != NULL) {
if (pipe(p_stdin) != 0)
return -1;
}
if (infp != NULL) {
if (pipe(p_stdout) != 0) {
if (outfp != NULL) {
close(p_stdin[0]);
close(p_stdin[1]);
}
return (-1);
}
}
pid = fork();
if (pid < 0) {
n_log(LOG_ERR, "Couldn't fork command %s", command);
if (outfp != NULL) {
close(p_stdin[0]);
close(p_stdin[1]);
}
if (infp != NULL) {
close(p_stdout[0]);
close(p_stdout[1]);
}
return pid;
}
if (pid == 0) {
if (outfp != NULL) {
close(p_stdin[1]);
dup2(p_stdin[0], 0);
}
if (infp != NULL) {
close(p_stdout[0]);
dup2(p_stdout[1], 1);
}
execlp("sh", "sh", "-c", command, (char*)NULL);
// should never get here
int error = errno;
n_log(LOG_ERR, "%s:%d: exec failed: %s", __FILE__, __LINE__, strerror(error));
exit(42);
}
if (infp != NULL) {
close(p_stdout[1]);
*infp = p_stdout[0];
}
if (outfp != NULL) {
close(p_stdin[0]);
*outfp = p_stdin[1];
}
return pid;
} /* system_nb */
#endif /* ifndef __windows__ */
void N_HIDE_STR(char* buf, ...) {
size_t it = 0;
va_list args;
va_start(args, buf);
int arg = 0;
while ((arg = va_arg(args, int))) {
buf[it] = (char)arg;
it++;
}
buf[it] = '\0';
va_end(args);
} /* N_HIDE_STR */
char* n_get_file_extension(char path[]) {
char* result = NULL;
size_t i = 0, n = 0;
__n_assert(path, return "");
n = strlen(path);
i = n - 1;
while ((i > 0) && (path[i] != '.') && (path[i] != '/') && (path[i] != '\\')) {
i--;
}
if ((i > 0) && (i < n - 1) && (path[i] == '.') && (path[i - 1] != '/') && (path[i - 1] != '\\')) {
result = path + i;
} else {
result = path + n;
}
return result;
}
Modules
- AABB3D
- ACCEPT_POOL
- ALLEGRO4
- ALLEGRO5
- ANIM_LIB
- ASTAR
- ATLAS_LIB
- AVRO
- CLOCK_SYNC
- COMMONS
- CONFIGFILE
- CYPHER_BASE64
- CYPHER_VIGENERE
- DEAD_RECKONING
- ENUMS
- EXCEPTIONS
- GAME_ENV
- GIT
- GUI
- HASH_TABLE
- ISOMETRIC_ENGINE
- LIST
- LOG
- LOGNODUP
- LZ4
- NETWORKING
- NETWORK_MSG
- N_COOKIES
- N_DIFF
- N_DIGEST
- N_DISK_CACHE
- N_DNS
- N_ECC
- N_ENTROPY
- N_FILES
- N_FLUIDS
- N_GUI_COLOR
- N_GUI_COLORWHEEL
- N_GUI_CURVE
- N_GUI_GRID
- N_GUI_POPUP
- N_HEX
- N_HTTP3
- N_HTTP_COOKIE
- N_HTTP_FORM
- N_HTTP_MIME
- N_HTTP_REQ
- N_HTTP_RESP
- N_HTTP_ROUTER
- N_HTTP_SERVER
- N_ICC
- N_JSON
- N_KAFKA
- N_LINALG
- N_MODULE
- N_OPENSSL_COMPAT
- N_PRETTY
- N_PTH
- N_QUERY
- N_RANDOM
- N_SHA256
- N_STR
- N_TIFF
- N_TIME
- N_USER
- N_X509
- N_ZIP
- PARTICLES
- PCRE
- PHYSICS
- SIGNALS
- STACK
- THREADS
- TRAJECTORY
- TREE
- ZLIB