https://github.com/semaj87/basic-thread
Minimal threading framework written in C
https://github.com/semaj87/basic-thread
c linux-kernel operating-systems processes system-programming threads
Last synced: 3 months ago
JSON representation
Minimal threading framework written in C
- Host: GitHub
- URL: https://github.com/semaj87/basic-thread
- Owner: semaj87
- License: mit
- Created: 2021-03-13T14:21:31.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-03-15T19:14:56.000Z (over 5 years ago)
- Last Synced: 2025-06-24T21:05:52.580Z (about 1 year ago)
- Topics: c, linux-kernel, operating-systems, processes, system-programming, threads
- Language: C
- Homepage:
- Size: 202 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Basic Thread
## Overview
This project was carried out to better understand the steps needed to develop threads using C within a given process.
Processes and threads can be thought of as the execution units of any operating system. A process can be thought
of as a running instance of a program, that is the time at which a binary executable is executed. Leading on from that,
a thread can be thought of as a unit of execution within a process - It is a possible flow of execution of the main process.
A given process has at least one thread (the main thread), ensuring that all threads run concurrently in a multithreaded process.
Threads are an efficient way to improve the performance of an application through parallelism. For example, in a browser, multiple
tabs can be different threads. Or, MS word uses multiple threads, one thread to format the text, other thread to process inputs, etc.
The main implementation in C was done utilizing the **[POSIX threads/pthreads](https://en.wikipedia.org/wiki/POSIX_Threads)** standard, the **[pthread_create()](https://linux.die.net/man/3/pthread_create)** function and the
**[pthread_join()](https://linux.die.net/man/3/pthread_join)** function.
## Structure
```bash
.
├── Dockerfile
├── LICENSE
├── README.md
├── img
│ └── single-and-multithreaded-processes.png
└── src
├── Makefile
├── main.c
├── pthreadCreateErrorHandler.c
├── pthreadCreateErrorHandler.h
├── pthreadJoinErrorHandler.c
├── pthreadJoinErrorHandler.h
├── routine.c
└── routine.h
```
## Prerequisites
- Docker
## Usage
1. To build the Docker image
```bash
docker build -t threads .
```
2. To run and enter the threads container
```bash
docker run -v ${PWD}/src:/src -it threads
```
3. Change into the src directory
```bash
cd src
```
4. Run the Makefile to build and run the threads executable
```bash
make
```
5. To clean the src directory of all object files and the threads executable
```bash
make clean
```
## License
Distributed under the MIT license - Please see the **LICENSE** file for more information.
## Acknowledgements
- C++ System Programming Cookbook - Onorato Vaticone
- How Linux Works, 2nd Edition - Brian Ward
- GeekforGeeks - [Thread function in C/C++](https://www.geeksforgeeks.org/thread-functions-in-c-c/)
- Linux Docs - [Pthread Docs](https://www.die.net/)
## Contact
- Name: James Aymer
- Email: [aymerjames@gmail.com](mailto:aymerjames@gmail.com)
- Linkedin: https://uk.linkedin.com/in/jamesaymer
- Github: https://github.com/JaymoAymer