Skip to content

Commit c4e65b5

Browse files
authored
Update documentation
2 parents e15f83b + a0716b2 commit c4e65b5

File tree

5 files changed

+8
-138
lines changed

5 files changed

+8
-138
lines changed

β€Ž.reuse/dep5β€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Files: setup.cfg
2222
Copyright: 2021 LG Electronics
2323
License: Apache-2.0
2424

25-
Files: docs/*
25+
Files: db/*
2626
Copyright: 2021 LG Electronics
2727
License: Apache-2.0
2828

β€ŽREADME.mdβ€Ž

Lines changed: 7 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -5,101 +5,20 @@ SPDX-License-Identifier: Apache-2.0
55
# FOSSLight Binary Scanner
66
<img src="https://img.shields.io/pypi/l/fosslight_binary" alt="FOSSLight Binary is released under the Apache-2.0." /> <img src="https://img.shields.io/pypi/v/fosslight_binary" alt="Current python package version." /> <img src="https://img.shields.io/pypi/pyversions/fosslight_binary" /> [![REUSE status](https://api.reuse.software/badge/github.com/fosslight/fosslight_binary_scanner)](https://api.reuse.software/info/github.com/fosslight/fosslight_binary_scanner)
77

8-
```note
8+
## πŸ’‘ Introduction
99
It searches for a binary and outputs OSS information
1010
if there is an identical or similar binary from the Binary DB.
11-
```
1211

12+
## πŸ“– User Guide
1313

14-
## Contents
14+
We describe the user guide in the FOSSLight guide page.
15+
Please see the [**User Guide**](https://fosslight.org/fosslight-guide-en/scanner/4_binary.html) for more information on how to install and run it.
1516

16-
- [Prerequisite](#-prerequisite)
17-
- [How to install](#-how-to-install)
18-
- [How to run](#-how-to-run)
19-
- [Result](#-result)
20-
- [Development](#-development)
21-
- [How it works](#-how-it-works)
22-
- [How to report issue](#-how-to-report-issue)
23-
- [License](#-license)
17+
## πŸ‘ Contributing Guide
2418

19+
We always welcome your contributions.
20+
Please see the [CONTRIBUTING guide](https://fosslight.org/fosslight-guide-en/learn/1_contribution.html) for how to contribute.
2521

26-
## πŸ“‹ Prerequisite
27-
- FOSSLight Binary Scanner needs a Python 3.6+.
28-
- To use the function to extract OSS information (OSS Name, OSS Version, License) from Binary DB, see the [database setting guide][db_guide].
29-
30-
[db_guide]: https://github.com/fosslight/fosslight_binary/blob/main/docs/SETUP_DATABASE.md
31-
32-
## πŸŽ‰ How to install
33-
It can be installed using pip3. It is recommended to install it in the [python 3.6 + virtualenv](https://fosslight.org/fosslight-guide-en/scanner/etc/guide_virtualenv.html) environment.
34-
35-
```
36-
$ pip3 install fosslight_binary
37-
```
38-
39-
## πŸš€ How to run
40-
````
41-
$ fosslight_binary -p [path_to_analyze]
42-
````
43-
### About parameters
44-
45-
| Parameter | Argument | Description |
46-
| ------------- | ------------- | ------------- |
47-
| h | None | Print help message. |
48-
| p | String | Path to detect binaries. |
49-
| o | String | Output directory. |
50-
| f | String | Output filename. |
51-
| a | String | Target architecture to output. (ex. x86-64, ARM) |
52-
| d | String | DB Connection Information. (ex. postgresql://username:password@host:port/database_name) |
53-
54-
## 🧐 How it works
55-
1. Extract binaries.
56-
1-0. Excluding linked files and FIFO files from binaries.
57-
1-1. Except when the extension is ['png', 'gif', 'jpg', 'bmp', 'jpeg', 'qm', 'xlsx', 'pdf', 'ico', 'pptx', 'jfif', 'docx',
58-
'doc', 'whl', 'xls', 'xlsm', 'ppt', 'mp4', 'pyc', 'plist']
59-
1-2. Except when the file type is ['data','timezone data', 'apple binary property list']
60-
1-3. Except when the directory is ['.git']
61-
1-4. Check "Exclude"
62-
- binary is ['fosslight_bin', 'fosslight_bin.exe']
63-
- directory is ["test", "tests", "doc", "docs"]
64-
1-5. With the -a option, output as binary only when the relevant information is included in the file command result.
65-
2. Extract checksum and tlsh for each binary.
66-
3. Load OSS information from Binary DB.
67-
4. Create binary.txt file.
68-
5. Create excel & csv file.
69-
70-
## πŸ“ Result
71-
72-
```
73-
$ tree
74-
.
75-
β”œβ”€β”€ binary_20210601_201646.txt
76-
β”œβ”€β”€ fosslight_bin_log_20210601_201646.txt
77-
β”œβ”€β”€ FOSSLight-Report_20210601_201646_BIN.csv
78-
└── FOSSLight-Report_20210601_201646.xlsx
79-
80-
```
81-
- FOSSLight-Report_[datetime].xlsx : FOSSLight binary result in FOSSLight Report format.
82-
- FOSSLight-Report_[datetime]_BIN.csv : FOSSLight binary result in csv format. (Except Windows)
83-
- fosslight_bin_log_[datetime].txt : The execution log.
84-
- binary_[datetime].txt : The checksum and tlsh values for each binary.
85-
86-
## πŸ’» Development
87-
### How to make an executable
88-
````
89-
$ pip install .
90-
$ pyinstaller --onefile cli.py -n cli --additional-hooks-dir=hooks
91-
````
92-
### How to test
93-
````
94-
$ pip install requiremets-dev.txt
95-
$ tox
96-
````
97-
98-
## πŸ‘ How to report issue
99-
100-
Please report any ideas or bugs to improve by creating an issue in [Git Repository][repo]. Then there will be quick bug fixes and upgrades. Ideas to improve are always welcome.
101-
102-
[repo]: https://github.com/fosslight/fosslight_binary_scanner/issues
10322

10423
## πŸ“„ License
10524

File renamed without changes.

β€Ždocs/SETUP_DATABASE.mdβ€Ž

Lines changed: 0 additions & 49 deletions
This file was deleted.

β€Ždocs/table_schema.pngβ€Ž

-25.3 KB
Binary file not shown.

0 commit comments

Comments
Β (0)