Mercurial > crates > systemd-socket
annotate src/error.rs @ 5:27456533853e
Attempt to setup CI using GitHub Actions
This sets up CI to test the crate on Ubuntu, Windows and macOS. It's expected to fail on Windows now and it will be fixed after we know which things need to be configured-away.
| author | Martin Habovštiak <martin.habovstiak@gmail.com> |
|---|---|
| date | Fri, 27 Nov 2020 15:18:25 +0100 |
| parents | 66c0e10c89fc |
| children | a7893294e9b2 |
| rev | line source |
|---|---|
| 0 | 1 //! Error types that can occur when dealing with `SocketAddr` |
| 2 //! | |
| 3 //! This module separates the error types from root module to avoid clutter. | |
| 4 | |
| 5 | |
| 6 use thiserror::Error; | |
| 7 use std::io; | |
| 8 | |
| 9 /// Error that can occur during parsing of `SocketAddr` from a string | |
| 10 /// | |
| 11 /// This encapsulates possible errors that can occur when parsing the input. | |
| 12 /// It is currently opaque because the representation is not certain yet. | |
| 13 /// It can be displayed using the standard `Error` trait. | |
| 14 #[derive(Debug, Error)] | |
| 15 #[error(transparent)] | |
| 16 pub struct ParseError(#[from] pub(crate) ParseErrorInner); | |
| 17 | |
| 18 #[derive(Debug, Error)] | |
| 19 pub(crate) enum ParseErrorInner { | |
| 20 #[error("failed to parse socket address")] | |
|
4
66c0e10c89fc
Support resolving hostnames
Martin Habovstiak <martin.habovstiak@gmail.com>
parents:
2
diff
changeset
|
21 ResolvAddr(#[from] crate::resolv_addr::ResolvAddrError), |
| 0 | 22 #[error("invalid character '{c}' in systemd socket name {string} at position {pos}")] |
|
2
cabc4aafdd85
Added length check and a few tests
Martin Habovstiak <martin.habovstiak@gmail.com>
parents:
0
diff
changeset
|
23 InvalidCharacter { string: String, c: char, pos: usize, }, |
|
cabc4aafdd85
Added length check and a few tests
Martin Habovstiak <martin.habovstiak@gmail.com>
parents:
0
diff
changeset
|
24 #[error("systemd socket name {string} is {len} characters long which is more than the limit 255")] |
|
cabc4aafdd85
Added length check and a few tests
Martin Habovstiak <martin.habovstiak@gmail.com>
parents:
0
diff
changeset
|
25 LongSocketName { string: String, len: usize, }, |
| 0 | 26 } |
| 27 | |
| 28 /// Error that can occur during parsing of `SocketAddr` from a `OsStr`/`OsString` | |
| 29 /// | |
| 30 /// As opposed to parsing from `&str` or `String`, parsing from `OsStr` can fail due to one more | |
| 31 /// reason: invalid UTF-8. This error type expresses this possibility and is returned whenever such | |
| 32 /// conversion is attempted. It is not opaque because the possible variants are pretty much | |
| 33 /// certain, but it may contain `ParseError` which is opaque. | |
| 34 /// | |
| 35 /// This error can be displayed using standard `Error` trait. | |
| 36 /// See `ParseError` for more information. | |
| 37 #[derive(Debug, Error)] | |
| 38 pub enum ParseOsStrError { | |
| 39 /// The input was not a valid UTF-8 string | |
| 40 #[error("the address is not a valid UTF-8 string")] | |
| 41 InvalidUtf8, | |
| 42 /// The input was a valid UTF-8 string but the address was invalid | |
| 43 #[error(transparent)] | |
| 44 InvalidAddress(#[from] ParseError), | |
| 45 } | |
| 46 | |
| 47 /// Error that can occur during binding of a socket | |
| 48 /// | |
| 49 /// This encapsulates possible errors that can occur when binding a socket or receiving a socket | |
| 50 /// from systemd. | |
| 51 /// It is currently opaque because the representation is not certain yet. | |
| 52 /// It can be displayed using the standard `Error` trait. | |
| 53 #[derive(Debug, Error)] | |
| 54 #[error(transparent)] | |
| 55 pub struct BindError(#[from] pub(crate) BindErrorInner); | |
| 56 | |
| 57 #[derive(Debug, Error)] | |
| 58 pub(crate) enum BindErrorInner { | |
| 59 #[error("failed to bind {addr}")] | |
| 60 BindFailed { addr: std::net::SocketAddr, #[source] error: io::Error, }, | |
|
4
66c0e10c89fc
Support resolving hostnames
Martin Habovstiak <martin.habovstiak@gmail.com>
parents:
2
diff
changeset
|
61 #[error("failed to bind {addr}")] |
|
66c0e10c89fc
Support resolving hostnames
Martin Habovstiak <martin.habovstiak@gmail.com>
parents:
2
diff
changeset
|
62 BindOrResolvFailed { addr: crate::resolv_addr::ResolvAddr, #[source] error: io::Error, }, |
| 0 | 63 #[error("failed to receive descriptors with names")] |
| 64 ReceiveDescriptors(#[source] crate::systemd_sockets::Error), | |
| 65 #[error("missing systemd socket {0} - a typo or an attempt to bind twice")] | |
| 66 MissingDescriptor(String), | |
| 67 #[error("the systemd socket {0} is not an internet socket")] | |
| 68 NotInetSocket(String), | |
| 69 } | |
| 70 | |
| 71 /// Error that can happen when binding Tokio socket. | |
| 72 /// | |
| 73 /// As opposed to `std` and `async_std` sockets, tokio sockets can fail to convert. | |
| 74 /// This error type expresses this possibility. | |
| 75 #[cfg(any(feature = "tokio_0_2", feature = "tokio_0_3"))] | |
| 76 #[derive(Debug, Error)] | |
| 77 #[error(transparent)] | |
| 78 pub enum TokioBindError { | |
| 79 /// Either binding of socket or receiving systemd socket failed | |
| 80 Bind(#[from] BindError), | |
| 81 /// Conversion from std `std::net::TcpListener` to `tokio::net::TcpListener` failed | |
| 82 Convert(#[from] TokioConversionError), | |
| 83 } | |
| 84 | |
| 85 /// Error that can happen when converting Tokio socket. | |
| 86 /// | |
| 87 /// As opposed to `std` and `async_std` sockets, tokio sockets can fail to convert. | |
| 88 /// This error type encapsulates conversion error together with additional information so that it | |
| 89 /// can be displayed nicely. The encapsulation also allows for future-proofing. | |
| 90 #[cfg(any(feature = "tokio_0_2", feature = "tokio_0_3"))] | |
| 91 #[derive(Debug, Error)] | |
| 92 #[error("failed to convert std socket {addr} into tokio socket")] | |
| 93 pub struct TokioConversionError { | |
| 94 pub(crate) addr: crate::SocketAddrInner, | |
| 95 #[source] | |
| 96 pub(crate) error: io::Error, | |
| 97 } | |
| 98 |