rxgen: Anchor kafs.RemoteAbort class to module

Anchor the kafs.RemoteAbort exception class to module so that it can be
referred to by name from scripts.

Signed-off-by: David Howells <dhowells@redhat.com>

Implement "vos partinfo"

Signed-off-by: David Howells <dhowells@redhat.com>

Implement 'vos listpart'

Signed-off-by: David Howells <dhowells@redhat.com>

Move VL connection security determination into cell.py

Move the Volume Location DB connection security handling into
cell.open_vl_server() as it's common to all vos commands.  It can be
configured directly by passing in a dictionary holding the appropriate
parameters.

Signed-off-by: David Howells <dhowells@redhat.com>

Provide generic check for non-combinable parameters

Provide generic check for non-combinable parameters in command py files.  A
list of tuples of pairs of argument names that don't interact is provided by
the name cant_combine_arguments as a global var.

Signed-off-by: David Howells <dhowells@redhat.com>

Allow RxRPC transport security to be requested

Honour the -encrypt flag to vos listvldb and make it tell AF_RXRPC to secure
the connection.  This requires an appropriate key to be available in one of
the user's keyrings, labelled:

afs@<UPPERCASE.CELL.NAME>

Without such a key, error:

[Errno 126] Required key not available

will be issued.

Signed-off-by: David Howells <dhowells@redhat.com>

"vos listvldb -server xxx" takes a fileserver name, not a vlserver name

"vos listvldb -server xxx" takes a fileserver name, not a vlserver name, so
provide a class for that and change the argument list.

Signed-off-by: David Howells <dhowells@redhat.com>

Create 'vos listvldb' command

rxgen: Need to align after encoding an array of bytes or a string

Padding may need to be inserted after encoding an array of bytes or a string
to bring the buffer to 4-byte alignment.

Signed-off-by: David Howells <dhowells@redhat.com>

Remove unused files

Move to mostly asynchronous model and emit server side pieces

Move to a mostly asynchronous model for sending and receiving RPC calls and
also emit server side pieces.

Signed-off-by: David Howells <dhowells@redhat.com>

Add call to VL_ListAttribute() to test program and fix stuff

Fix the following things:

 (1) Calculation of iovecs for filling the reply data circular buffer from
     recvmsg().

 (2) Set the circular buffer tail pointer correctly when discarding extraneous
     data in the final reply decode phase when waiting for MSG_EOR.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Use the xg files as sources for rxgen

Use the Arla xg files rather than C headers as sources for the rxgen script.

Signed-off-by: David Howells <dhowells@redhat.com>

xg: More cleanups

More cleanups to the xg files.

Signed-off-by: David Howells <dhowells@redhat.com>

xg: Reindent the xg files

Reindent the xg files to use tabs.

Signed-off-by: David Howells <dhowells@redhat.com>

xg: All integer types should be in terms of stdint

All integer types should be in terms of stdint:

int8_t uint8_t
int16_t uint16_t
int32_t uint32_t
int64_t uint64_t

Long should not be used as it may be 32-bits or 64-bits.

Signed-off-by: David Howells <dhowells@redhat.com>

xg: Clean up Arla xg files

Clean up Arla xg files to remove CVS-isms and Arla-specific bits.

Signed-off-by: David Howells <dhowells@redhat.com>

Import the Arla XG files

Import the Arla XG files.  These are RxRPC RPC API definitions for rxgen to
turn into compilables.

They are licensed under the 3-clause BSD licence from Royal Institute of
Technology, Stockholm, Sweden, which is GPL-compatible.

Signed-off-by: David Howells <dhowells@redhat.com>

Integrate the afs_xg.h contents back into afs.h and afs_vl.h

Integrate the afs_xg.h contents back into afs.h and afs_vl.h and get rid of
the afs_xg.h file.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Extract C synchronous RPC func emitter

Extract the code to emit C functions to perform synchronous RPC calls from the
main rxgen script and put into its own module.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Extract C struct marshal/unmarshal code emitter

Extract the code to emit the code to marshal/unmarshal C structures from the
main rxgen script and put into its own perl module.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Extract py module emitter

Extract the code to emit the python module creation code from the main rxgen
script and put into its own perl module.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Turn the py module emitter into a perl subroutine

Turn the python module defining code emitter into a perl subroutine within the
main rxgen script.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Extract py wrapper type emitter

Extract the code to emit python wrapper types from the main rxgen script
and put into its own module.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Extract py wrapper func emitter

Extract the code to emit python wrapper functions from the main rxgen script
and put into its own module.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Make lists of constants, structs and funcs global

Make lists of constants, structs and funcs global within the rxgen perl script
and any modules it uses.

Signed-off-by: David Howells <dhowells@redhat.com>

rxgen: Move rxgen.pl to its own dir

Move rxgen.pl to its own dir so that it can be split up.

Signed-off-by: David Howells <dhowells@redhat.com>

Initial code commit now that the VLDB lookup test python script works

The rxgen.pl script takes a C header file, parses it for #defined constants,
structures declarations and synchronous RPC call function declarations and
emits the following:

- C functions to marshal/unmarshal structs.
- C functions to marshal func arguments and dispatch the request.
- C functions to unmarshal the replies.
- C functions to provide synchronous RPC calls matching the source.
- A python module containing:
  - Python types to wrap the structs.
  - Python methods to wrap the synchronous RPC calls.
  - Python constants to wrap the constants.

It cannot yet handle functions that deal in bulk types/lists of structs and
functions that take interpolated chunks of arbitrary data.

It also does not yet emit server-side parts or top layer of the asynchronous
client side stuff.

It requires python v3 and requires the AF_RXRPC socket family to be available
in the kernel.

A script called "vl-test.py" is included that can be used to test the
functionality.  Run without arguments, it will attempt to retrieve the
"afs.root" volume from the grand.central.org AFS cell.

The test script uses the DNS so may require a python3-dns package installing.

Signed-off-by: David Howells <dhowells@redhat.com>

Initial revision