# 过滤器位置
ls /usr/lib/cups/filter/

# 后端位置
ls /usr/lib/cups/backend/

# MIME 类型定义
cat /etc/cups/mime.types

# MIME 转换规则
cat /etc/cups/mime.convs

# 查看所有过滤器
find /usr/lib/cups/filter -type f -executable

# 查看所有后端
find /usr/lib/cups/backend -type f -executable

# MIME 类型定义
cat /etc/cups/mime.types

# /etc/cups/mime.types

# PDF 文件检测
application/pdf    pdf string(0,"%PDF")

# PostScript 文件检测
application/postscript    ai eps ps string(0,"%!")

# 纯文本文件检测
text/plain    txt string(0,#!) print("/bin/sh") print("/bin/bash") print("/usr/bin/env")
text/plain    txt asc c cc h hh cpp cxx hxx java pl py rb

# 图像文件检测
image/jpeg    jpg jpeg string(0,\377\330\377\340) string(0,\377\330\377\341)
image/png     png string(0,\211PNG)
image/gif     gif string(0,GIF87a) string(0,GIF89a)
image/tiff    tif tiff string(0,MM\000\052) string(0,II\052\000)
image/bmp     bmp string(0,BM)

# HP-GL/2 文件
application/vnd.hp-HPGL    hpgl string(0,IN;) string(0,IN\n)

# CUPS 光栅数据
application/vnd.cups-raster    string(0,RaSt)
application/vnd.cups-pdf    string(0,%PDF)

# OpenDocument
application/vnd.oasis.opendocument.text    odt zip(string(0,PK\003\004),filename="mimetype",content="application/vnd.oasis.opendocument.text")

# Microsoft Office
application/msword    doc zip(string(0,PK\003\004),filename="[Content_Types].xml",content="word/")
application/vnd.openxmlformats-officedocument.wordprocessingml.document    docx zip(string(0,PK\003\004),filename="[Content_Types].xml",content="word/")

# MIME 类型检测语法
# 类型  扩展名  检测规则

# 检测规则类型:
# string(offset, "content")  - 字符串匹配
# char(offset, value)         - 字节匹配
# icalendar(offset)           - iCalendar 检测
# pdf(offset)                 - PDF 特征检测
# zip(offset, filename, content) - ZIP 内文件检测

# 示例:
# 检测 PDF 文件 (%PDF 在文件开头)
application/pdf    pdf string(0,"%PDF")

# 检测 ZIP 文件中的 Office 文档
application/vnd.openxmlformats-officedocument.wordprocessingml.document
    docx zip(string(0,PK\003\004),
             filename="[Content_Types].xml",
             content="word/")

# 检测 ELF 二进制文件
application/x-executable    * string(0,\177ELF)

# 添加自定义 MIME 类型
sudo vim /etc/cups/mime.types

# 添加自定义文件类型
application/x-custom    cust string(0,"CUSTOM1.0")

# 添加新的 Office 格式
application/vnd.lotus-1-2-3    wks wk1 wk3 wk4 string(0,\000\000\002\000)

# MIME 转换规则
cat /etc/cups/mime.convs

# /etc/cups/mime.convs

# PDF 转 PostScript
application/pdf    application/postscript    33    pdftops

# PDF 转 CUPS Raster
application/pdf    application/vnd.cups-raster    50    pdftoraster

# PostScript 转 CUPS Raster
application/postscript    application/vnd.cups-raster    50    gstoraster

# 文本转 PostScript
text/plain    application/postscript    33    texttops

# 文本转 CUPS Raster
text/plain    application/vnd.cups-raster    50    texttoraster

# 图像转 PostScript
image/jpeg    application/postscript    33    imagetops
image/png     application/postscript    33    imagetops
image/gif     application/postscript    33    imagetops

# 图像转 CUPS Raster
image/jpeg    application/vnd.cups-raster    50    imagetoraster

# PostScript 转 PCL
application/postscript    application/vnd.hp-pcl    50    gstopxl

# PostScript 转 PDF
application/postscript    application/pdf    33    pstopdf

# CUPS Raster 转 PCL-XL
application/vnd.cups-raster    application/vnd.hp-pclxl    50    rastertopclx

# CUPS Raster 转 HP PCL
application/vnd.cups-raster    application/vnd.hp-pcl    50    rastertohp

# 语法格式:
# 源类型    目标类型    优先级    过滤器程序

# 参数说明:
# 源类型: 输入文档的 MIME 类型
# 目标类型: 输出文档的 MIME 类型
# 优先级: 数字越小优先级越高 (0-100)
# 过滤器: 转换程序路径或名称

# 优先级说明:
# 0-10:    系统保留
# 11-30:   高优先级
# 31-50:   中优先级
# 51-70:   低优先级
# 71-100:  很少使用

# 添加自定义转换规则
sudo vim /etc/cups/mime.convs

# 添加 Office 文档转换规则
application/msword    application/pdf    50    doc2pdf
application/vnd.openxmlformats-officedocument.wordprocessingml.document    application/pdf    50    docx2pdf

# 添加自定义图像转换规则
application/x-custom    application/postscript    33    custom2ps

# 使用 cupsfilter 查看转换链
cupsfilter -m application/pdf -p myprinter /dev/null 2>&1

# 输出示例:
# pdftops (PID 1234) application/pdf → application/postscript
# pstops (PID 1235) application/postscript → application/postscript
# gstopxl (PID 1236) application/postscript → application/vnd.hp-pclxl

# 使用 verbose 模式查看详细信息
cupsfilter -v -m application/pdf -p myprinter /dev/null

# 手动测试过滤器
# PDF 转 PostScript
cupsfilter -m application/postscript document.pdf > output.ps

# PDF 转光栅
cupsfilter -m application/vnd.cups-raster document.pdf > output.raster

# 文本转 PostScript
echo "Hello World" | cupsfilter -m application/postscript > output.ps

# 使用特定打印机配置
cupsfilter -d myprinter -m application/postscript document.pdf > output.ps

# pdftops 将 PDF 转换为 PostScript
# 使用 Poppler 库实现

# 测试 pdftops
pdftops document.pdf output.ps

# 选项:
# -level1      使用 PostScript Level 1
# -level2      使用 PostScript Level 2
# -level3      使用 PostScript Level 3 (默认)
# -nocrop      不裁剪页面
# -expand      扩展页面
# -noshrink    不收缩页面
# -nocenter    不居中页面
# -landscape   横向打印
# -paper size  设置纸张大小
# -form        生成表单

# 测试命令
pdftops -level2 -paper A4 document.pdf output.ps

# pdftoraster 将 PDF 转换为 CUPS Raster 格式
# 使用 Poppler 或 MuPDF

# 测试 pdftoraster
pdftoraster document.pdf > output.raster

# CUPS Raster 格式:
# - 包含页面头信息
# - 包含光栅图像数据
# - 支持多种颜色空间
# - 支持多种分辨率

# imagetops 将图像转换为 PostScript
# 支持 JPEG, PNG, GIF, BMP, TIFF 等

# 测试 imagetops
imagetops image.jpg > output.ps

# 选项通过环境变量传递:
# FINAL_CONTENT_TYPE  输出内容类型
# PRINTER             打印机名称
# copies              打印份数
# media               纸张大小
# number-up           每页多版
# orientation-requested 方向
# page-bottom          下边距
# page-left            左边距
# page-right           右边距
# page-top             上边距
# scaling              缩放比例
# sides                双面打印

# texttops 将纯文本转换为 PostScript

# 测试 texttops
texttops document.txt > output.ps

# 选项:
# -c columns     每页列数
# -f font-name   字体名称
# -m             使用等宽字体
# -n copies      打印份数
# -p             纵向打印
# -r             横向打印
# -s             严格换页

# 示例
texttops -f Courier -c 80 document.txt > output.ps

# Ghostscript 相关过滤器
ls /usr/lib/cups/filter/ | grep -i ghost

# gstoraster: PS/PDF 转 CUPS Raster
gstoraster document.ps > output.raster

# gstopxl: PS 转 PCL-XL
gstopxl document.ps > output.pxl

# gstopclm: PS 转 PCLm
gstopclm document.ps > output.pclm

# Ghostscript 设备列表
gs -h 2>&1 | grep -A 50 "Available devices:" | head -30

# 后端程序需要特殊权限
# 查看后端权限
ls -la /usr/lib/cups/backend/

# 输出示例:
# -rwxr-xr-x 1 root root  45K usb
# -rwxr-xr-x 1 root root  34K socket
# -rwxr-xr-x 1 root root  56K ipp
# -rwsr-xr-x 1 root root  23K serial    # SUID 位

# USB 后端需要特殊权限
sudo chmod 700 /usr/lib/cups/backend/usb
sudo chown root:root /usr/lib/cups/backend/usb

# 串口后端需要 SUID 位
sudo chmod 4755 /usr/lib/cups/backend/serial

# 测试后端
# 列出可用后端
lpinfo -v

# 测试 socket 后端
/usr/lib/cups/backend/socket 1 1 user "test" 1 "" /tmp/test.ps

# 测试 IPP 后端
/usr/lib/cups/backend/ipp 1 1 user "test" 1 "" /tmp/test.ps

# 测试设备发现
/usr/lib/cups/backend/snmp
/usr/lib/cups/backend/dnssd

# 后备后端提供故障转移功能
# 当主后端失败时，自动切换到备选后端

# URI 格式:
# beh:/number_of_retries/delay/original_backend original_uri

# 示例：重试 3 次，每次间隔 5 秒
sudo lpadmin -p MyPrinter -E \
  -v "beh:/3/5/socket/socket://192.168.1.100:9100" \
  -P /usr/share/ppd/HP/hp-laserjet_pro_m404.ppd

# 使用 IPP 后备
sudo lpadmin -p MyPrinter -E \
  -v "beh:/3/5/ipp/ipp://192.168.1.100/ipp/print" \
  -m "everywhere"

# CUPS 过滤器命令行接口:
# filter job-id user title copies options [file]

# 参数说明:
# job-id   - 任务 ID
# user     - 用户名
# title    - 文档标题
# copies   - 打印份数
# options  - 打印选项（空格分隔）
# file     - 输入文件（可选，不提供则从 stdin 读取）

# 输入: stdin 或 file
# 输出: stdout
# 日志: stderr

# 返回值:
# 0 - 成功
# 1 - 错误（任务将被取消）
# 2 - 错误（任务将被重试）

#!/bin/bash
# /usr/lib/cups/filter/myfilter
# 简单的自定义过滤器示例

# 获取参数
JOB_ID="$1"
USER="$2"
TITLE="$3"
COPIES="$4"
OPTIONS="$5"
FILE="$6"

# 记录日志
echo "DEBUG: Filter started - Job: $JOB_ID, User: $USER, Title: $TITLE" >&2

# 处理输入
if [ -n "$FILE" ]; then
    INPUT="$FILE"
else
    INPUT="/dev/stdin"
fi

# 执行转换（这里只是示例，实际应实现转换逻辑）
cat "$INPUT"

echo "DEBUG: Filter completed successfully" >&2
exit 0

# 安装过滤器
sudo cp myfilter /usr/lib/cups/filter/myfilter
sudo chmod 755 /usr/lib/cups/filter/myfilter
sudo chown root:root /usr/lib/cups/filter/myfilter

#!/usr/bin/env python3
# /usr/lib/cups/filter/pdf-watermark.py
# PDF 水印过滤器

import sys
import os
import subprocess
from pathlib import Path

def add_watermark(input_file, watermark_text):
    """为 PDF 添加水印"""
    try:
        # 创建水印 PDF
        watermark_ps = f"""
%!PS-Adobe-3.0
%%Title: Watermark
/Helvetica-Bold findfont 60 scalefont setfont
0.5 setgray
306 396 moveto
-45 rotate
({watermark_text}) stringwidth pop -2 div 0 rmoveto
({watermark_text}) show
"""
        # 使用 Ghostscript 添加水印
        cmd = [
            'gs', '-dNOPAUSE', '-dBATCH', '-sDEVICE=pdfwrite',
            '-sOutputFile=-', '-c',
            f'<< /EndPage {{ 2 eq {{ pop false }} {{ /Helvetica-Bold findfont 60 scalefont setfont 0.5 setgray 306 396 moveto -45 rotate ({watermark_text}) show true }} ifelse }} bind >> setpagedevice',
            '-f', input_file
        ]
        result = subprocess.run(cmd, capture_output=True, text=True)
        return result.stdout
    except Exception as e:
        print(f"ERROR: {e}", file=sys.stderr)
        return None

def main():
    if len(sys.argv) < 6:
        print("Usage: pdf-watermark job user title copies options [file]", file=sys.stderr)
        sys.exit(1)
    
    job_id = sys.argv[1]
    user = sys.argv[2]
    title = sys.argv[3]
    copies = sys.argv[4]
    options = sys.argv[5]
    input_file = sys.argv[6] if len(sys.argv) > 6 else None
    
    # 解析选项
    watermark_text = "CONFIDENTIAL"
    for opt in options.split():
        if opt.startswith("watermark="):
            watermark_text = opt.split("=", 1)[1]
    
    # 读取输入
    if input_file:
        with open(input_file, 'rb') as f:
            data = f.read()
    else:
        data = sys.stdin.buffer.read()
    
    # 临时文件处理
    import tempfile
    with tempfile.NamedTemporaryFile(suffix='.pdf', delete=False) as tmp:
        tmp.write(data)
        tmp_path = tmp.name
    
    try:
        result = add_watermark(tmp_path, watermark_text)
        if result:
            sys.stdout.buffer.write(result)
        else:
            # 如果处理失败，输出原始文件
            sys.stdout.buffer.write(data)
    finally:
        os.unlink(tmp_path)
    
    print(f"DEBUG: Watermark filter completed", file=sys.stderr)
    sys.exit(0)

if __name__ == "__main__":
    main()

# 安装 Python 过滤器
sudo cp pdf-watermark.py /usr/lib/cups/filter/pdf-watermark
sudo chmod 755 /usr/lib/cups/filter/pdf-watermark

# 注册 MIME 类型
sudo vim /etc/cups/mime.types
# 添加:
# application/x-watermarked-pdf    wpdf string(0,"%PDF")

# 注册转换规则
sudo vim /etc/cups/mime.convs
# 添加:
# application/pdf    application/x-watermarked-pdf    33    pdf-watermark

# 或者注册为覆盖特定打印机的过滤器
# 在 PPD 文件中添加:
# *cupsFilter: "application/pdf 0 pdf-watermark"

#!/bin/bash
# /usr/lib/cups/filter/office2pdf
# Office 文档转 PDF 过滤器

JOB_ID="$1"
USER="$2"
TITLE="$3"
COPIES="$4"
OPTIONS="$5"
FILE="$6"

LOGFILE="/var/log/cups/office2pdf.log"

log() {
    echo "$(date '+%Y-%m-%d %H:%M:%S') $*" >> "$LOGFILE"
}

log "Starting office2pdf filter - Job: $JOB_ID, User: $USER"

# 获取输入文件类型
if [ -n "$FILE" ]; then
    INPUT="$FILE"
    FILE_TYPE=$(file -b --mime-type "$FILE")
else
    # 保存 stdin 到临时文件
    INPUT=$(mktemp /tmp/cups-XXXXXX)
    cat > "$INPUT"
    FILE_TYPE=$(file -b --mime-type "$INPUT")
    trap "rm -f $INPUT" EXIT
fi

log "Input file type: $FILE_TYPE"

# 根据文件类型选择转换工具
case "$FILE_TYPE" in
    application/msword|application/vnd.openxmlformats-officedocument.wordprocessingml.document)
        # 使用 LibreOffice 转换
        log "Converting Office document to PDF"
        libreoffice --headless --convert-to pdf --outdir /tmp "$INPUT" 2>> "$LOGFILE"
        PDF_FILE="/tmp/$(basename "${INPUT%.*}").pdf"
        if [ -f "$PDF_FILE" ]; then
            cat "$PDF_FILE"
            rm -f "$PDF_FILE"
        else
            log "ERROR: LibreOffice conversion failed"
            exit 1
        fi
        ;;
    application/pdf)
        # 直接输出 PDF
        cat "$INPUT"
        ;;
    *)
        log "Unsupported file type: $FILE_TYPE"
        exit 1
        ;;
esac

log "Filter completed successfully"
exit 0

# 基本语法
cupsfilter [选项] [文件]

# 常用选项:
# -D           调试模式
# -d printer   使用指定打印机
# -m mime/type 输出 MIME 类型
# -n copies    打印份数
# -o option=value 打印选项
# -p ppd-file  使用指定 PPD 文件
# -t title     文档标题

# 测试 PDF 到 PostScript 转换
cupsfilter -m application/postscript document.pdf > output.ps

# 使用特定打印机
cupsfilter -d myprinter -m application/postscript document.pdf > output.ps

# 使用特定 PPD 文件
cupsfilter -p /usr/share/ppd/HP/hp-laserjet_pro_m404.ppd \
  -m application/postscript document.pdf > output.ps

# 测试文本到光栅转换
echo "Test Page" | cupsfilter -m application/vnd.cups-raster > output.raster

# 启用详细输出
cupsfilter -v -m application/pdf document.pdf > /dev/null

# 输出示例:
# DEBUG: Loading printer "myprinter"
# DEBUG: Finding filter for application/pdf to application/postscript
# DEBUG: Running filter: pdftops 1234 user "Test" 1 "" document.pdf
# DEBUG: Filter completed with status 0

# 列出可用转换路径
cupsfilter -t application/pdf 2>&1 | head -20

# 测试完整转换链
cupsfilter -d myprinter -v document.pdf 2>&1

# /etc/cups/mime.convs
# 优化转换路径

# 直接 PDF 到光栅（跳过 PostScript）
application/pdf    application/vnd.cups-raster    33    pdftoraster

# 提高特定过滤器优先级
image/jpeg    application/postscript    25    imagetops

# 禁用特定过滤器
# 不使用 texttops，改用 texttoraster
# text/plain    application/postscript    33    texttops
text/plain    application/vnd.cups-raster    33    texttoraster

# CUPS 过滤器可用的环境变量

# FINAL_CONTENT_TYPE  最终输出类型
# PRINTER             打印机名称
# DEVICE_URI          设备 URI
# CONTENT_TYPE        输入内容类型
# SERVER_ADMIN        管理员邮箱
# CUPS_SERVER         CUPS 服务器地址
# IPP_PORT            IPP 端口
# LOCALE              语言环境

# 在过滤器中使用环境变量
echo "Printer: $PRINTER" >&2
echo "Device: $DEVICE_URI" >&2
echo "Content: $CONTENT_TYPE → $FINAL_CONTENT_TYPE" >&2

# 需求：自动将 Office 文档转换为 PDF 打印

# 安装 LibreOffice
sudo apt install -y libreoffice-common

# 创建 Office 转 PDF 过滤器
sudo vim /usr/lib/cups/filter/office2pdf
# （参考上面的脚本）

# 注册 MIME 类型
sudo vim /etc/cups/mime.types
# 添加:
# application/msword    doc string(0,\320\317\021\340\241\261\032\341)
# application/vnd.openxmlformats-officedocument.wordprocessingml.document
#     docx zip(string(0,PK\003\004))

# 注册转换规则
sudo vim /etc/cups/mime.convs
# 添加:
# application/msword    application/pdf    33    office2pdf
# application/vnd.openxmlformats-officedocument.wordprocessingml.document
#     application/pdf    33    office2pdf

# 测试
lp -d myprinter document.docx

# 需求：为敏感文档自动添加水印

# 使用 Python 过滤器
sudo vim /usr/lib/cups/filter/security-watermark
# （参考上面的 Python 脚本）

# 注册过滤器
sudo vim /etc/cups/mime.convs
# application/pdf    application/x-watermarked-pdf    33    security-watermark

# 测试
lp -d myprinter -o watermark="CONFIDENTIAL" sensitive-document.pdf

#!/bin/bash
# /usr/lib/cups/filter/audit-logger
# 审计日志过滤器（透明记录）

JOB_ID="$1"
USER="$2"
TITLE="$3"
COPIES="$4"
OPTIONS="$5"
FILE="$6"

# 记录打印活动
LOGFILE="/var/log/cups/audit.log"
echo "$(date '+%Y-%m-%d %H:%M:%S') | User: $USER | Job: $JOB_ID | Title: $TITLE | Copies: $COPIES | Options: $OPTIONS" >> "$LOGFILE"

# 计算文件大小
if [ -n "$FILE" ]; then
    SIZE=$(stat -c%s "$FILE" 2>/dev/null || echo "0")
else
    SIZE=$(cat | wc -c)
    echo "$SIZE bytes" >> "$LOGFILE"
    # 重新输出内容
    cat /dev/stdin
fi

# 透明传递
cat "$FILE" 2>/dev/null || cat /dev/stdin
exit 0