Cargo.toml — это файл, содержащий зависимости и конфигурацию для компиляции.
main.rs — это основной файл, который будет скомпилирован вместе с возможными каталогами, содержащими библиотеки.

Для компиляции проекта перейдите в каталог проекта и выполните:  
`cargo build`

Это будет использовать вашу цепочку инструментов по умолчанию.
Если вы хотите собрать финальную «release» версию, выполните:  
`cargo build --release`

Для статических двоичных файлов в терминале перед командой сборки выполните:  
`"C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"`  
`set RUSTFLAGS=-C target-feature=+crt-static`

Если вам неудобно читать мой код в том виде, в каком он написан,
вы также можете использовать следующую команду внутри каталога проекта, чтобы отформатировать его более удобным способом  
`cargo fmt`

Некоторые примеры могут не скомпилироваться и выдавать ошибку, так как может потребоваться ночная сборка
Rust с последними функциями. Чтобы установить её, просто выполните:  
`rustup default nightly`  



Самый простой способ найти зависимости или [Crates](https://crates.io/), как они называются.

## Кросс-компиляция

Кросс-компиляция требует следования инструкциям [здесь](https://rust-lang.github.io/rustup/cross-compilation.html)
Установив различные цепочки инструментов, вы можете выполнять кросс-компиляцию с помощью следующей команды  
`cargo build --target <toolchain>`  

Чтобы увидеть установленные цепочки инструментов в вашей системе, выполните:  
`rustup toolchain list`  

Чтобы проверить все доступные для установки цепочки инструментов, выполните:  
`rustup target list`  

Для установки новой цепочки инструментов выполните:  
`rustup target add <toolchain_name>`  


## Оптимизация исполняемых файлов по размеру

Этот [репозиторий](https://github.com/johnthagen/min-sized-rust) содержит множество опций конфигурации и идей по уменьшению размера файла.
Статические двоичные файлы обычно довольно большие.

## Ловушки, в которые я сам попадал

Остерегайтесь нулевых байтов, не забывайте их для строк в памяти. Я потратил много времени, но windbg всегда помогал решить эту проблему.


## Интересные библиотеки Rust

- WINAPI  
- [WINAPI2](https://github.com/MauriceKayser/rs-winapi2)  
- Windows — это официальная библиотека от Microsoft, с которой я не особо игрался

## OPSEC

- Хотя Rust имеет хорошие преимущества, к нему довольно сложно привыкнуть, и он не очень интуитивен.  
- Генерация шелл-кода — ещё одна проблема из-за LLVM. Я нашёл несколько способов подойти к этому.  
[Donut](https://github.com/TheWover/donut) иногда генерирует работающий шелл-код, но в зависимости от того, как сделан проект, это может не сработать.  
В целом, для генерации шелл-кода инструменты должны быть сделаны так, чтобы размещать весь код в сегменте .text,
что приводит к этому замечательному [репозиторию](https://github.com/b1tg/rust-windows-shellcode).
В этом проекте есть пример шелл-кода, который покажет, как структурировать код для успешной генерации шелл-кода.  
Кроме того, в этом проекте также есть генератор шелл-кода, который извлекает сегмент .text двоичного файла и
и выгружает шелл-код после выполнения некоторых патчей.  
Этот проект берёт двоичный файл из определённого места, поэтому я сделал форк, который принимает путь к двоичному файлу в качестве аргумента [здесь](https://github.com/trickster0/rust-windows-shellcode-custom).  
- Даже если вы удалите все отладочные символы, Rust всё равно может сохранять ссылки на ваш домашний каталог в двоичном файле. Единственный способ, который я нашёл, чтобы удалить это — передать следующий флаг: `--remap-path-prefix {ваш домашний каталог}={случайный идентификатор}`. Вы можете использовать переменные bash для получения домашнего каталога и генерации случайного заполнителя: `--remap-path-prefix "$HOME"="$RANDOM"`. (Автор [Yamakadi](https://github.com/yamakadi))
- Хотя для описанного выше есть другой способ удалить информацию о домашнем каталоге, добавив в начало Cargo.toml  
`cargo-features = ["strip"]` .  
Поскольку Rust по умолчанию оставляет много вещей в виде строк в двоичном файле, я в основном использую этот [cargo.toml](../master/cargo.toml), чтобы избежать этого и уменьшить размер  
с командой сборки   
`cargo build --release -Z build-std=std,panic_abort -Z build-std-features=panic_immediate_abort --target x86_64-pc-windows-msvc`
- [Yamakadi] также указал, что в зависимости от импортированных библиотек, stripping не всегда последовательно скрывает домашний каталог, поэтому комбинация его решения с переназначением пути и использования вышеуказанного cargo будет работать лучше. Постарайтесь быть внимательными и проверять свои двоичные файлы перед запуском в ваших миссиях на предмет потенциальных строк, которые не были удалены должным образом.

## Другие проекты, которые я сделал на Rust

- [UDPlant](https://github.com/trickster0/UDPlant) — По сути, UDP-обратный шелл  
- [EDR Detector](https://github.com/trickster0/EDR_Detector) — Обнаруживает EDR установленной системы по установленным .sys файлам  
- [Lenum](https://github.com/trickster0/Lenum) — Простой инструмент для перечисления в Unix

## Полезные проекты на Rust

- [houdini](https://github.com/yamakadi/houdini) — Помогает сделать ваш исполняемый файл самоудаляемым