This file is indexed.

/usr/share/pyshared/txsocksx/grammar.py is in python-txsocksx 1.13.0.0-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 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
# Copyright (c) Aaron Gallagher <_@habnab.it>
# See COPYING for details.

import socket

grammarSource = r"""

byte = anything:b -> ord(b)
short = byte:high byte:low -> (high << 8) | low
cstring = <(~'\x00' anything)*>:string '\x00' -> string

ipv4Address = <anything{4}>:packed -> socket.inet_ntop(socket.AF_INET, packed)
ipv6Address = <anything{16}>:packed -> socket.inet_ntop(socket.AF_INET6, packed)

SOCKS4Command = ( '\x01' -> 'tcp-connect'
                | '\x02' -> 'tcp-bind'
                )
SOCKS4HostUser = ipv4Address:host cstring:user -> (host, user)
SOCKS4aHostUser = ( '\x00'{3} ~'\x00' anything cstring:user cstring:host -> (host, user)
                  | SOCKS4HostUser
                  )

SOCKS4Request = '\x04' SOCKS4Command:command short:port SOCKS4aHostUser:hostuser -> (command, port) + hostuser
SOCKS4Response = '\x00' byte:status short:port ipv4Address:address -> (status, address, port)


SOCKS4ServerState_initial = SOCKS4Request:request -> receiver.clientRequest(*request)
SOCKS4ClientState_initial = SOCKS4Response:response -> receiver.serverResponse(*response)


SOCKS5Command = (SOCKS4Command | '\x03' -> 'udp-associate')
SOCKS5Hostname = byte:length <anything{length}>:host -> host
SOCKS5Address = ( '\x01' ipv4Address:address -> address
                | '\x03' SOCKS5Hostname:host -> host
                | '\x04' ipv6Address:address -> address
                )

SOCKS5ServerAuthSelection = '\x05' anything
SOCKS5ServerLoginResponse = anything anything:status -> status == '\x00'
SOCKS5ServerResponse = '\x05' byte:status '\x00' SOCKS5Address:address short:port -> (status, address, port)

SOCKS5ClientGreeting = '\x05' byte:authMethodCount byte{authMethodCount}:authMethods -> authMethods or []
SOCKS5ClientRequest = '\x05' SOCKS5Command:command '\x00' SOCKS5Address:address short:port -> (command, address, port)


SOCKS5ServerState_initial = SOCKS5ClientGreeting:authMethods -> receiver.authRequested(authMethods)
SOCKS5ServerState_readRequest = SOCKS5ClientRequest:request -> receiver.clientRequest(*request)

SOCKS5ClientState_initial = SOCKS5ServerAuthSelection:selection -> receiver.authSelected(selection)
SOCKS5ClientState_readLoginResponse = SOCKS5ServerLoginResponse:response -> receiver.loginResponse(response)
SOCKS5ClientState_readResponse = SOCKS5ServerResponse:response -> receiver.serverResponse(*response)


SOCKSState_readData = anything:data -> receiver.dataReceived(data)

"""

bindings = {'socket': socket}