aboutsummaryrefslogtreecommitdiff
path: root/test/fuse_integration/posix_Makefile
blob: 4eaa6396c48c4dcd018a0a9280a65e8fccd96fcd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
# SeaweedFS POSIX Compliance Testing Makefile

# Configuration
WEED_BINARY := $(shell which weed 2>/dev/null || echo "../../weed")
GO_VERSION := 1.21
TEST_TIMEOUT := 45m
COVERAGE_FILE := posix_coverage.out
REPORT_DIR := reports
EXTERNAL_TOOLS_DIR := external_tools

# Test categories
POSIX_BASIC_TESTS := posix_compliance_test.go
POSIX_EXTENDED_TESTS := posix_extended_test.go  
POSIX_EXTERNAL_TESTS := posix_external_test.go

# Colors for output
RED := \033[31m
GREEN := \033[32m
YELLOW := \033[33m
BLUE := \033[34m
MAGENTA := \033[35m
CYAN := \033[36m
WHITE := \033[37m
RESET := \033[0m

.DEFAULT_GOAL := help

# Prerequisites checks
check-binary:
	@if [ ! -f "$(WEED_BINARY)" ]; then \
		echo "$(RED)❌ SeaweedFS binary not found at $(WEED_BINARY)$(RESET)"; \
		echo "   Please run 'make' in the root directory first"; \
		exit 1; \
	fi
	@echo "$(GREEN)[OK] SeaweedFS binary found at $(WEED_BINARY)$(RESET)"

check-fuse:
	@if command -v fusermount >/dev/null 2>&1; then \
		echo "$(GREEN)[OK] FUSE is installed (Linux)$(RESET)"; \
	elif command -v umount >/dev/null 2>&1 && [ "$$(uname)" = "Darwin" ]; then \
		echo "$(GREEN)[OK] FUSE is available (macOS)$(RESET)"; \
	else \
		echo "$(RED)❌ FUSE not found. Please install:$(RESET)"; \
		echo "   Ubuntu/Debian: sudo apt-get install fuse"; \
		echo "   CentOS/RHEL:   sudo yum install fuse"; \
		echo "   macOS:         brew install macfuse"; \
		exit 1; \
	fi

check-go:
	@go version | grep -q "go1\.[2-9][0-9]" || \
	go version | grep -q "go1\.2[1-9]" || \
	(echo "$(RED)❌ Go $(GO_VERSION)+ required. Current: $$(go version)$(RESET)" && exit 1)
	@echo "$(GREEN)[OK] Go version check passed$(RESET)"

check-prereqs: check-go check-fuse check-binary
	@echo "$(GREEN)[OK] All prerequisites satisfied$(RESET)"

# Setup and initialization
init-module:
	@if [ ! -f go.mod ]; then \
		echo "$(BLUE)📦 Initializing Go module...$(RESET)"; \
		go mod init seaweedfs-posix-tests; \
		go mod tidy; \
	fi

setup-reports:
	@mkdir -p $(REPORT_DIR)
	@mkdir -p $(EXTERNAL_TOOLS_DIR)

setup-external-tools: setup-reports
	@echo "$(BLUE)🛠️  Setting up external POSIX test tools...$(RESET)"
	@$(MAKE) setup-pjdfstest
	@$(MAKE) setup-nfstest
	@$(MAKE) setup-fio

# External tools setup
setup-pjdfstest:
	@if [ ! -d "$(EXTERNAL_TOOLS_DIR)/pjdfstest" ]; then \
		echo "$(BLUE)[SETUP] Setting up pjdfstest...$(RESET)"; \
		cd $(EXTERNAL_TOOLS_DIR) && \
		git clone https://github.com/pjd/pjdfstest.git && \
		cd pjdfstest && \
		autoreconf -ifs && \
		./configure && \
		make; \
	else \
		echo "$(GREEN)[OK] pjdfstest already setup$(RESET)"; \
	fi

setup-nfstest:
	@echo "$(BLUE)[INSTALL] Installing nfstest...$(RESET)"
	@pip3 install --user nfstest 2>/dev/null || \
	echo "$(YELLOW)[WARNING] nfstest installation failed. Install manually: pip3 install nfstest$(RESET)"

setup-fio:
	@if ! command -v fio >/dev/null 2>&1; then \
		echo "$(BLUE)[SETUP] Installing FIO...$(RESET)"; \
		if command -v apt-get >/dev/null 2>&1; then \
			sudo apt-get update && sudo apt-get install -y fio; \
		elif command -v yum >/dev/null 2>&1; then \
			sudo yum install -y fio; \
		elif command -v brew >/dev/null 2>&1; then \
			brew install fio; \
		else \
			echo "$(YELLOW)[WARNING] Please install FIO manually$(RESET)"; \
		fi; \
	else \
		echo "$(GREEN)[OK] FIO already installed$(RESET)"; \
	fi

# Core test execution
test-posix-basic: check-prereqs init-module setup-reports
	@echo "$(CYAN)[TEST] Running basic POSIX compliance tests...$(RESET)"
	@if [ -n "$(TEST_MOUNT_POINT)" ]; then \
		echo "$(BLUE)Using external mount point: $(TEST_MOUNT_POINT)$(RESET)"; \
		TEST_MOUNT_POINT="$(TEST_MOUNT_POINT)" TEST_SKIP_CLUSTER_SETUP="true" \
		go test -v -timeout $(TEST_TIMEOUT) -run TestPOSIXCompliance $(POSIX_BASIC_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_basic_results.log; \
	else \
		go test -v -timeout $(TEST_TIMEOUT) -run TestPOSIXCompliance $(POSIX_BASIC_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_basic_results.log; \
	fi

test-posix-extended: check-prereqs init-module setup-reports
	@echo "$(CYAN)[TEST] Running extended POSIX compliance tests...$(RESET)"
	@if [ -n "$(TEST_MOUNT_POINT)" ]; then \
		echo "$(BLUE)Using external mount point: $(TEST_MOUNT_POINT)$(RESET)"; \
		TEST_MOUNT_POINT="$(TEST_MOUNT_POINT)" TEST_SKIP_CLUSTER_SETUP="true" \
		go test -v -timeout $(TEST_TIMEOUT) -run TestPOSIXExtended $(POSIX_EXTENDED_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_extended_results.log; \
	else \
		go test -v -timeout $(TEST_TIMEOUT) -run TestPOSIXExtended $(POSIX_EXTENDED_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_extended_results.log; \
	fi

test-posix-external: check-prereqs init-module setup-reports setup-external-tools
	@echo "$(CYAN)[TEST] Running external POSIX test suite integration...$(RESET)"
	@if [ -n "$(TEST_MOUNT_POINT)" ]; then \
		echo "$(BLUE)Using external mount point: $(TEST_MOUNT_POINT)$(RESET)"; \
		TEST_MOUNT_POINT="$(TEST_MOUNT_POINT)" TEST_SKIP_CLUSTER_SETUP="true" \
		go test -v -timeout $(TEST_TIMEOUT) -run TestExternalPOSIXSuites $(POSIX_EXTERNAL_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_external_results.log; \
	else \
		go test -v -timeout $(TEST_TIMEOUT) -run TestExternalPOSIXSuites $(POSIX_EXTERNAL_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_external_results.log; \
	fi

# Comprehensive test suites
test-posix-full: test-posix-basic test-posix-extended test-posix-external
	@echo "$(GREEN)[OK] Full POSIX compliance test suite completed$(RESET)"
	@$(MAKE) generate-report

test-posix-critical: check-prereqs init-module setup-reports
	@echo "$(CYAN)[TEST] Running critical POSIX compliance tests...$(RESET)"
	@if [ -n "$(TEST_MOUNT_POINT)" ]; then \
		echo "$(BLUE)Using external mount point: $(TEST_MOUNT_POINT)$(RESET)"; \
		TEST_MOUNT_POINT="$(TEST_MOUNT_POINT)" TEST_SKIP_CLUSTER_SETUP="true" \
		go test -v -timeout 15m \
		-run "TestPOSIXCompliance/(FileOperations|DirectoryOperations|PermissionTests|IOOperations)" \
		$(POSIX_BASIC_TESTS) 2>&1 | tee $(REPORT_DIR)/posix_critical_results.log; \
	else \
		go test -v -timeout 15m \
		-run "TestPOSIXCompliance/(FileOperations|DirectoryOperations|PermissionTests|IOOperations)" \
		$(POSIX_BASIC_TESTS) 2>&1 | tee $(REPORT_DIR)/posix_critical_results.log; \
	fi

test-posix-stress: check-prereqs init-module setup-reports
	@echo "$(CYAN)[TEST] Running POSIX stress tests...$(RESET)"
	@go test -v -timeout $(TEST_TIMEOUT) \
		-run "TestExternalPOSIXSuites/CustomPOSIXTests" \
		$(POSIX_EXTERNAL_TESTS) 2>&1 | tee $(REPORT_DIR)/posix_stress_results.log

# Performance and benchmarks
benchmark-posix: check-prereqs init-module setup-reports
	@echo "$(CYAN)📈 Running POSIX performance benchmarks...$(RESET)"
	@go test -v -timeout $(TEST_TIMEOUT) -bench=. -benchmem \
		$(POSIX_BASIC_TESTS) $(POSIX_EXTENDED_TESTS) 2>&1 | \
		tee $(REPORT_DIR)/posix_benchmark_results.log

profile-posix: check-prereqs init-module setup-reports
	@echo "$(CYAN)[PROFILE] Running POSIX tests with profiling...$(RESET)"
	@go test -v -timeout $(TEST_TIMEOUT) -cpuprofile $(REPORT_DIR)/posix.cpu.prof \
		-memprofile $(REPORT_DIR)/posix.mem.prof -run TestPOSIXCompliance $(POSIX_BASIC_TESTS)
	@echo "$(GREEN)[PROFILE] Profiles generated:$(RESET)"
	@echo "  CPU: $(REPORT_DIR)/posix.cpu.prof"
	@echo "  Memory: $(REPORT_DIR)/posix.mem.prof"
	@echo "$(BLUE)View with: go tool pprof $(REPORT_DIR)/posix.cpu.prof$(RESET)"

# Coverage analysis
coverage-posix: check-prereqs init-module setup-reports
	@echo "$(CYAN)[COVERAGE] Running POSIX tests with coverage analysis...$(RESET)"
	@go test -v -timeout $(TEST_TIMEOUT) -coverprofile=$(REPORT_DIR)/$(COVERAGE_FILE) \
		$(POSIX_BASIC_TESTS) $(POSIX_EXTENDED_TESTS) $(POSIX_EXTERNAL_TESTS)
	@go tool cover -html=$(REPORT_DIR)/$(COVERAGE_FILE) -o $(REPORT_DIR)/posix_coverage.html
	@echo "$(GREEN)[COVERAGE] Coverage report generated: $(REPORT_DIR)/posix_coverage.html$(RESET)"

# External tool tests
test-pjdfstest: setup-external-tools
	@echo "$(CYAN)[TEST] Running pjdfstest suite...$(RESET)"
	@if [ -d "$(EXTERNAL_TOOLS_DIR)/pjdfstest" ]; then \
		cd $(EXTERNAL_TOOLS_DIR)/pjdfstest && \
		prove -r tests/ 2>&1 | tee ../../$(REPORT_DIR)/pjdfstest_results.log; \
	else \
		echo "$(RED)❌ pjdfstest not setup$(RESET)"; \
		exit 1; \
	fi

test-nfstest-posix:
	@echo "$(CYAN)[TEST] Running nfstest_posix...$(RESET)"
	@if command -v nfstest_posix >/dev/null 2>&1; then \
		mkdir -p /tmp/nfstest_mount; \
		nfstest_posix --path /tmp/nfstest_mount --verbose 2>&1 | \
		tee $(REPORT_DIR)/nfstest_results.log; \
	else \
					echo "$(YELLOW)[WARNING] nfstest_posix not available$(RESET)"; \
	fi

# FIO-based performance tests
test-fio-posix: setup-reports
	@echo "$(CYAN)[TEST] Running FIO-based POSIX I/O tests...$(RESET)"
	@$(MAKE) create-fio-configs
	@if command -v fio >/dev/null 2>&1; then \
		for config in $(REPORT_DIR)/fio_*.conf; do \
			echo "$(BLUE)Running FIO config: $$config$(RESET)"; \
			fio $$config --output=$(REPORT_DIR)/$$(basename $$config .conf)_results.log; \
		done; \
	else \
					echo "$(YELLOW)[WARNING] FIO not available$(RESET)"; \
	fi

create-fio-configs: setup-reports
	@echo "$(BLUE)[CONFIG] Creating FIO test configurations...$(RESET)"
	@echo "[global]" > $(REPORT_DIR)/fio_random_rw.conf
	@echo "name=posix_random_rw" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "ioengine=sync" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "iodepth=1" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "rw=randrw" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "bs=4k" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "direct=0" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "size=100m" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "numjobs=4" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "runtime=30" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "time_based" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "[random_rw_test]" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "directory=/tmp/seaweedfs_mount" >> $(REPORT_DIR)/fio_random_rw.conf
	@echo "[global]" > $(REPORT_DIR)/fio_sequential.conf
	@echo "name=posix_sequential" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "ioengine=sync" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "iodepth=1" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "bs=1m" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "direct=0" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "size=500m" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "runtime=60" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "time_based" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "[seq_write]" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "rw=write" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "directory=/tmp/seaweedfs_mount" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "[seq_read]" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "rw=read" >> $(REPORT_DIR)/fio_sequential.conf
	@echo "directory=/tmp/seaweedfs_mount" >> $(REPORT_DIR)/fio_sequential.conf

# Reporting and analysis
generate-report: setup-reports
	@echo "$(BLUE)[REPORT] Generating comprehensive POSIX compliance report...$(RESET)"
	@$(MAKE) generate-html-report
	@$(MAKE) generate-text-report
	@$(MAKE) generate-json-report

generate-html-report:
	@echo "$(BLUE)[REPORT] Generating HTML report...$(RESET)"
	@echo "<!DOCTYPE html>" > $(REPORT_DIR)/posix_compliance_report.html
	@echo "<html><head><title>SeaweedFS POSIX Compliance Report</title>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "<style>body{font-family:Arial;margin:20px}.pass{color:green}.fail{color:red}</style>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "</head><body><h1>SeaweedFS POSIX Compliance Report</h1>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "<p>Generated on: $$(date)</p>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "<h2>Test Results</h2>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "<p>Detailed test results are available in the text and JSON reports.</p>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "</body></html>" >> $(REPORT_DIR)/posix_compliance_report.html
	@echo "$(GREEN)[OK] HTML report generated: $(REPORT_DIR)/posix_compliance_report.html$(RESET)"

generate-text-report:
	@echo "$(BLUE)[REPORT] Generating text report...$(RESET)"
	@echo "SeaweedFS POSIX Compliance Report" > $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "=================================" >> $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "" >> $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "Generated: $$(date)" >> $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "SeaweedFS Version: $$($(WEED_BINARY) version 2>/dev/null || echo 'Unknown')" >> $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "" >> $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "Test Summary: See individual log files for detailed results" >> $(REPORT_DIR)/posix_compliance_summary.txt
	@echo "$(GREEN)[OK] Text report generated: $(REPORT_DIR)/posix_compliance_summary.txt$(RESET)"

generate-json-report:
	@echo "$(BLUE)[REPORT] Generating JSON report...$(RESET)"
	@echo "{" > $(REPORT_DIR)/posix_compliance_report.json
	@echo "  \"report_type\": \"posix_compliance\"," >> $(REPORT_DIR)/posix_compliance_report.json
	@echo "  \"timestamp\": \"$$(date -u +"%Y-%m-%dT%H:%M:%SZ")\"," >> $(REPORT_DIR)/posix_compliance_report.json
	@echo "  \"seaweedfs_version\": \"$$($(WEED_BINARY) version 2>/dev/null | head -n1 || echo 'Unknown')\"," >> $(REPORT_DIR)/posix_compliance_report.json
	@echo "  \"test_environment\": { \"os\": \"$$(uname -s)\", \"arch\": \"$$(uname -m)\" }," >> $(REPORT_DIR)/posix_compliance_report.json
	@echo "  \"test_results\": \"See individual log files for detailed results\"" >> $(REPORT_DIR)/posix_compliance_report.json
	@echo "}" >> $(REPORT_DIR)/posix_compliance_report.json
	@echo "$(GREEN)[OK] JSON report generated: $(REPORT_DIR)/posix_compliance_report.json$(RESET)"

# Cleanup and maintenance
clean:
	@echo "$(YELLOW)🧹 Cleaning up test artifacts...$(RESET)"
	@rm -rf $(REPORT_DIR)
	@rm -rf /tmp/seaweedfs_*_test_*
	@go clean -testcache
	@echo "$(GREEN)[OK] Cleanup complete$(RESET)"

clean-external-tools:
	@echo "$(YELLOW)🧹 Cleaning up external tools...$(RESET)"
	@rm -rf $(EXTERNAL_TOOLS_DIR)

clean-all: clean clean-external-tools

# Development and debugging
validate:
	@echo "$(BLUE)[OK] Validating test files...$(RESET)"
	@go build -o /dev/null ./...
	@echo "$(GREEN)[OK] All test files compile successfully$(RESET)"

fmt:
	@echo "$(BLUE)🎨 Formatting Go code...$(RESET)"
	@go fmt ./...

lint:
	@echo "$(BLUE)🔍 Running linter...$(RESET)"
	@if command -v golangci-lint >/dev/null 2>&1; then \
		golangci-lint run; \
	else \
					echo "$(YELLOW)[WARNING] golangci-lint not found, running go vet instead$(RESET)"; \
		go vet ./...; \
	fi

# CI/CD integration
ci-posix-tests: check-prereqs init-module setup-external-tools
	@echo "$(CYAN)🚀 Running POSIX tests for CI/CD...$(RESET)"
	@$(MAKE) test-posix-critical
	@$(MAKE) generate-report

# Docker-based testing
docker-test-posix:
	@echo "$(BLUE)🐳 Running POSIX tests in Docker...$(RESET)"
	@docker build -f Dockerfile.posix -t seaweedfs-posix-tests ../..
	@docker run --rm --privileged -v $(PWD)/$(REPORT_DIR):/reports seaweedfs-posix-tests

# Documentation and help
list-tests:
	@echo "$(BLUE)📋 Available POSIX test functions:$(RESET)"
	@grep -r "^func Test" *.go 2>/dev/null | sed 's/.*func \(Test[^(]*\).*/  \1/' | sort || echo "No test files found"

test-info:
	@echo "$(BLUE)[INFO] POSIX Test Information:$(RESET)"
	@echo "Test files:"
	@echo "  - $(POSIX_BASIC_TESTS): Core POSIX compliance tests"
	@echo "  - $(POSIX_EXTENDED_TESTS): Extended POSIX feature tests"  
	@echo "  - $(POSIX_EXTERNAL_TESTS): External test suite integration"
	@echo ""
	@echo "External tools:"
	@echo "  - pjdfstest: Comprehensive POSIX filesystem test suite"
	@echo "  - nfstest: Network filesystem POSIX API verification"
	@echo "  - FIO: Flexible I/O performance testing"

help:
	@echo "$(CYAN)SeaweedFS POSIX Compliance Testing$(RESET)"
	@echo "=================================="
	@echo ""
	@echo "$(WHITE)Prerequisites:$(RESET)"
	@echo "  $(GREEN)make check-prereqs$(RESET)      - Check all prerequisites"
	@echo "  $(GREEN)make setup-external-tools$(RESET) - Setup external POSIX test tools"
	@echo ""
	@echo "$(WHITE)Core POSIX Tests:$(RESET)"
	@echo "  $(GREEN)make test-posix-basic$(RESET)    - Run basic POSIX compliance tests"
	@echo "  $(GREEN)make test-posix-extended$(RESET) - Run extended POSIX feature tests"
	@echo "  $(GREEN)make test-posix-external$(RESET) - Run external test suite integration"
	@echo "  $(GREEN)make test-posix-full$(RESET)     - Run complete POSIX test suite"
	@echo ""
	@echo "$(WHITE)Focused Tests:$(RESET)"
	@echo "  $(GREEN)make test-posix-critical$(RESET) - Run critical POSIX compliance tests"
	@echo "  $(GREEN)make test-posix-stress$(RESET)   - Run POSIX stress tests"
	@echo ""
	@echo "$(WHITE)Performance & Analysis:$(RESET)"
	@echo "  $(GREEN)make benchmark-posix$(RESET)     - Run POSIX performance benchmarks"
	@echo "  $(GREEN)make profile-posix$(RESET)       - Run tests with performance profiling"
	@echo "  $(GREEN)make coverage-posix$(RESET)      - Run tests with coverage analysis"
	@echo "  $(GREEN)make test-fio-posix$(RESET)      - Run FIO-based I/O performance tests"
	@echo ""
	@echo "$(WHITE)External Test Suites:$(RESET)"
	@echo "  $(GREEN)make test-pjdfstest$(RESET)      - Run pjdfstest suite"
	@echo "  $(GREEN)make test-nfstest-posix$(RESET)  - Run nfstest_posix"
	@echo ""
	@echo "$(WHITE)Reporting:$(RESET)"
	@echo "  $(GREEN)make generate-report$(RESET)     - Generate comprehensive compliance report"
	@echo ""
	@echo "$(WHITE)Development:$(RESET)"
	@echo "  $(GREEN)make validate$(RESET)            - Validate test file compilation"
	@echo "  $(GREEN)make fmt$(RESET)                 - Format Go code"
	@echo "  $(GREEN)make lint$(RESET)                - Run linter"
	@echo "  $(GREEN)make list-tests$(RESET)          - List available test functions"
	@echo ""
	@echo "$(WHITE)Maintenance:$(RESET)"
	@echo "  $(GREEN)make clean$(RESET)               - Clean up test artifacts"
	@echo "  $(GREEN)make clean-all$(RESET)           - Clean everything including external tools"
	@echo ""
	@echo "$(WHITE)CI/CD Integration:$(RESET)"
	@echo "  $(GREEN)make ci-posix-tests$(RESET)      - Run POSIX tests optimized for CI/CD"
	@echo "  $(GREEN)make docker-test-posix$(RESET)   - Run tests in Docker container"

.PHONY: help check-prereqs check-binary check-fuse check-go init-module setup-reports \
        setup-external-tools setup-pjdfstest setup-nfstest setup-fio \
        test-posix-basic test-posix-extended test-posix-external test-posix-full \
        test-posix-critical test-posix-stress benchmark-posix profile-posix coverage-posix \
        test-pjdfstest test-nfstest-posix test-fio-posix create-fio-configs \
        generate-report generate-html-report generate-text-report generate-json-report \
        clean clean-external-tools clean-all validate fmt lint ci-posix-tests \
        docker-test-posix list-tests test-info