port generating function signature