https://github.com/barimehdi77/ft_irc
Our own IRC server in C++, fully compatible with an official client.
https://github.com/barimehdi77/ft_irc
1337 1337school 42 42projects 42school ft-irc irc irc-bot irc-client irc-protocol irc-server
Last synced: 4 months ago
JSON representation
Our own IRC server in C++, fully compatible with an official client.
- Host: GitHub
- URL: https://github.com/barimehdi77/ft_irc
- Owner: barimehdi77
- Created: 2022-03-29T13:04:06.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-05-30T19:55:57.000Z (over 3 years ago)
- Last Synced: 2025-04-09T07:32:31.629Z (6 months ago)
- Topics: 1337, 1337school, 42, 42projects, 42school, ft-irc, irc, irc-bot, irc-client, irc-protocol, irc-server
- Language: C++
- Homepage:
- Size: 268 KB
- Stars: 18
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🤔 Description
This project is about creating our own IRC server. We used an actual IRC client to connect to our server and test it.
**IRC** (Internet Relay Chat) is a protocol for real-time text messaging between internet-connected computers created in **1988**. It is mainly used for group discussion in chat rooms called “**channels**” although it supports private messages between two users, data transfer, and various client-side commands.
## Mandatory part
- We have to develop an IRC server in C++ 98.
- The server must be capable of handling multiple clients at the same time and never hang.
- Only 1 poll() (or equivalent) can be used for handling all these operations (read, write, but also listen, and so forth).
- An IRC client must be able to connect to your server without encountering any error.
- Communication between client and server has to be done via TCP/IP (v4).
- Using the IRC client with our server must be similar to using it with any official IRC server. However, we only have to implement the following features:
- We must be able to authenticate, set a nickname, a username, join a channel, send and receive private messages using the IRC client.
- All the messages sent from one client to a channel have to be forwarded to every other client that joined the channel.
- We must have operators and regular users.
- Then, we have to implement the commands that are specific to operators.
## Bonus part
Here are the extra features we added to our IRC server so it looks even more like and actual IRC server:
- Handle file transfer.
- A meme bot named **DEEZNUTS**.
# 🔑 Our IRC Commands
These are the available commands in our IRC Server:
- **PASS**: The **PASS** command is used to set a 'connection password'.
- **NICK**: NICK command is used to give user a nickname or change the existing one.
- **USER**: he USER command is used at the beginning of connection to specify the username, hostname and realname of a new user.
- **OPER**: A normal user uses the OPER command to obtain operator privileges.
- **MODE**: The user MODE's are typically changes which affect either how the client is seen by others or what 'extra' messages the client is sent.
- **QUIT**: A client session is terminated with a quit message.
- **JOIN**: The JOIN command is used by a user to request to start listening to the specific channel.
- **PART**: The PART command causes the user sending the message to be removed from the list of active members for all given channels listed in the parameter string.
- **TOPIC**: The TOPIC command is used to change or view the topic of a channel.
- **KICK**: The KICK command can be used to request the forced removal of a user from a channel.
- **PRIVMSG**: PRIVMSG is used to send private messages between users, as well as to send messages to channels.
- **NOTICE**: The NOTICE command is used similarly to PRIVMSG.
- **SENDFILE**: The SENDFILE command is used to send a file to another user.
- **GETFILE**: The GETFILE command is used to receive a file from another user.
- **DEEZNUTS**: The DEEZNUTS command is a bot that helps you with various types of information about the server.
# ⚙️ Start IRC Server
To compile the program, use:
- `make`
To start the Server, use:
- `./ircserv `
- **port**: The port number on which your IRC server will be listening to for incoming IRC connections.
- **password**: The connection password. It will be needed by any IRC client that tries to connect to your server.
To connect to the server, you can use:
- `nc `
- **IP ADDRESS**: Host IP address.
- **PORT**: The PORT that the server listening on.
- You can also use an IRC Client e.g LimeChat, WeeChat...
# 💪 Contributers
[BARI Mehdi](https://github.com/barimehdi77)
42intra profile : [mbari](https://profile.intra.42.fr/users/mbari)
[SFAIHI Abderrahmane](https://github.com/AbderrSfa)
42intra profile : [asfaihi](https://profile.intra.42.fr/users/asfaihi)
[EL KEMMAL Abdelhamid](https://github.com/abdel-ke)
42intra profile : [abdel-ke](https://profile.intra.42.fr/users/abdel-ke)
# 👨💻 Ressources
* [What is a Socket?](https://www.tutorialspoint.com/unix_sockets/what_is_socket.htm)
* [Unix Socket - Network Addresses](https://www.tutorialspoint.com/unix_sockets/network_addresses.htm)
* [Unix Socket - Core Functions](https://www.tutorialspoint.com/unix_sockets/socket_core_functions.htm)
* [Beej's Guide to Network Programming](https://beej.us/guide/bgnet/html/)
* [The UChicago χ-Projects](http://chi.cs.uchicago.edu/chirc/index.html)
* [Internet Relay Chat Protocol](https://datatracker.ietf.org/doc/html/rfc1459)
* [Internet Relay Chat: Architecture](https://datatracker.ietf.org/doc/html/rfc2810)
* [Internet Relay Chat: Channel Management](https://datatracker.ietf.org/doc/html/rfc2811)
* [Internet Relay Chat: Client Protocol](https://datatracker.ietf.org/doc/html/rfc2812)
* [Internet Relay Chat: Server Protocol](https://datatracker.ietf.org/doc/html/rfc2813)
---
[](https://www.buymeacoffee.com/barimehdi77)
[](https://ko-fi.com/K3K45UOA7)
[](https://paypal.me/barimehdi77)