memflowup

Crates.iomemflowup
lib.rsmemflowup
version0.2.0
sourcesrc
created_at2022-01-04 12:39:39.675359
updated_at2024-10-05 09:13:57.971747
descriptionsetup tool for the memflow physical memory introspection framework
homepagehttps://memflow.github.io
repositoryhttps://github.com/memflow/memflowup
max_upload_size
id507772
size162,124
(ko1N)

documentation

https://docs.rs/memflowup

README

memflowup - memflow setup tool

This tool is meant to provide a really quick way to setup various memflow components (connectors, OS plugins, utilities).

The recommended way is to install it through our automated script:

curl --proto '=https' --tlsv1.2 -sSf https://sh.memflow.io | bash

Alternatively you can manually install it via cargo as well:

cargo install memflowup --force

Basic Usage

See the help:

memflowup help

Pull all plugins:

memflowup pull --all

List all locally installed plugins:

memflowup plugins ls

List all available plugins in the default registry (http://registry.memflow.io):

memflowup plugins ls

Delete a plugin locally:

memflowup plugins remove coredump

Cleanup old versions of locally installed plugins:

memflowup plugins clean

Install a plugin from a github repo:

memflowup build https://github.com/memflow/memflow-coredump

Install a plugin from a folder:

cd memflow-coredump
memflowup build -p .

All commands additionally have a help (append --help) associated with them.

Interacting with other registries

Memflowup features a configuration system that allows overriding some default properties.

To override the default registry run:

memflowup config set registry http://my-registry.io
memflowup config set pub_key_file /home/user/key_file.pub

All plugins in the memflow-registry are signed and the signature is checked by memflowup during the download process. Downloading from a custom registry requires setting up the according public key that was used for signing the files in the registry.

If you want to push to your own registry you also have to provide a token and the private key file which is used to sign plugins locally before publishing them.

Migrate from memflowup 0.1

  • Delete all system-wide installed plugins in /usr/lib/memflow

  • Delete all installed plugins for the current user in ~/.local/lib/memflow

  • Delete the /etc/memflowup folder

  • Reinstall all plugins via memflowup pull --all

Troubleshooting:

  • In case you are using Mac OS and encounter an error building proc-macro2 run xcode-select --install
Commit count: 107

cargo fmt